スキップしてメイン コンテンツに移動

【Day 48】.git フォルダを解剖する 〜Gitの物理データ構造〜

Day 48 アイキャッチ
▲ 【Day 48】.git フォルダを解剖する 〜Gitの物理データ構造〜
👨‍🏫
皆さんこんにちは! 本講座の専任講師です。
前回(Day 47)は、Gitの強力な二分探索機能である git bisect を使って、100個以上のコミットから単体テスト(dotnet test)と連携してバグ混入コミットを全自動特定するデバッグ技法を学びました。
そして本日から、いよいよ本講座の集大成・クライマックスとなる「第10部:Git内部アーキテクチャ深掘り」に突入します!
記念すべき第1弾のテーマは【.git フォルダを解剖する 〜Gitの物理データ構造〜】です!
30年選手のベテランエンジニアの方から、長年の疑問を突く素晴らしい質問が届いています:
「Subversion(SVN)を使っていた頃は、すべてのサブディレクトリの中に『.svn』という隠しフォルダが作られ、ファイルを整理したり別プロジェクトへコピーするたびに不整合が起きて大変な思いをしました。
一方Gitは、プロジェクトのルートディレクトリにたった1つだけ『.git』フォルダがあるだけです。
この『.git』の中をエクスプローラーやPowerShellで覗いてみると、HEADやconfig、refs、objects、indexといった謎のファイル群が並んでいます。
Gitは裏で一体どんなデータ構造を使って、プロジェクトの全ファイル・全ブランチ・全歴史をファイルシステム上に保存しているのでしょうか? ブラックボックスの中身を物理レベルで解剖して教えてください!」

実に素晴らしい着眼点ですね! まさにベテランエンジニアならではの探究心です。
Gitのコマンドをただ暗記しているだけだと、「ブランチを切る」「コミットする」「元に戻す」といった操作が魔法のように見えて、万が一のトラブルの際に恐怖を感じてしまいます。
しかし、.git フォルダの中身を開けて物理構造を理解してしまえば、「Gitは驚くほどシンプルで美しいファイルベースのキーバリューストア(KVS)である」という真実が見えてきます。
仕組みがわかれば、ブランチ操作が一瞬で終わる理由も、消えたコミットがreflogで復旧できる理由も、すべて一本の線で繋がります。
本日はPowerShellを片手に、Gitの心臓部である .git フォルダを徹底解剖していきましょう!

① SVNの .svn フォルダ vs Gitの .git フォルダ:なぜGitはルートに1つだけなのか?

長年Subversion(SVN)やVisual SourceSafe(VSS)でC#プロジェクトを管理してきたエンジニアにとって、Gitのリポジトリ構造は最初に感動するポイントの一つです。
かつてのSVN(特にバージョン1.6以前)では、チェックアウトしたリポジトリのすべてのサブディレクトリの中に .svn という隠しディレクトリがばら撒かれていました。

SVNの .svn vs Gitの .git
▲ 【図解①】各フォルダに散乱するSVN vs ルートに1つだけ集中するGit

このSVNの「フォルダ散乱型」には、現場で数多くの頭痛の種がありました:

  • フォルダ移動・コピーの事故:エクスプローラーでサブフォルダを別場所にコピーすると、古いリポジトリ情報を持つ .svn まで複製されてしまい、コミット時に大混乱を起こす。
  • 検索やビルドのノイズ:Grep検索やバッチ処理で .svn 配下の内部ファイルがヒットしてしまい、余計な除外設定が必要になる。
  • クリーンアップの手間:納品用ソースコードを作る際、すべての階層から .svn を手動またはスクリプトで削除(svn export)しなければならなかった。

これに対し、Gitはプロジェクトのルートにたった1つだけ .git フォルダを置くという極めてクリーンな設計を採用しています。
配下の src/ や Controllers/ などの作業ディレクトリには、余計なメタデータファイルが一切存在しません。ソースコードは100%純粋な状態に保たれます。
さらに、プロジェクトをまるごと別のディスクに移動したり、zip圧縮してバックアップを取る際も、ルートの .git さえ含まれていれば、リポジトリの全コミット履歴・全ブランチ・全タグが1バイトの欠損もなく完全に移植できます!

② .git フォルダの中身を全解剖:主要ファイルとディレクトリの物理的役割

では、実際にリポジトリの .git フォルダを開いてみましょう。
PowerShellで Get-ChildItem -Force .git を実行すると、以下のような構成が確認できます:

PS C:\Projects\MyCSharpApp> Get-ChildItem -Force .git

Mode LastWriteTime Length Name
---- ------------- ------ ----
d--h- 2026/11/16 10:00 hooks
d--h- 2026/11/16 10:00 info
d--h- 2026/11/16 10:00 objects
d--h- 2026/11/16 10:00 refs
-a-h- 2026/11/16 10:00 23 HEAD
-a-h- 2026/11/16 10:00 284 config
-a-h- 2026/11/16 10:00 73 description
-a-h- 2026/11/16 10:00 1024 index
.git フォルダを支える4大要素
▲ 【図解②】.git フォルダを構成する4つのコア要素(HEAD, refs/, objects/, index)

この中で、日々のバージョン管理の中核を担っている「4大コア要素」がこちらです:

構成要素 ファイル形式 物理的な役割と中身
① HEAD テキスト (23B) 現在作業中のブランチを指す看板。
中身はたった1行 ref: refs/heads/main
② refs/heads/ テキスト (41B) ローカルブランチの実体。ブランチ名と同じ名前のファイル内に、そのブランチの最新コミットハッシュ(40桁)が1行だけ書かれている。
③ objects/ zlib圧縮バイナリ Gitの全データ金庫。ファイル内容(Blob)、フォルダ構造(Tree)、コミット情報(Commit)がSHA-1ハッシュ値で命名され、zlibで圧縮保存されている。
④ index 独自バイナリ ステージングエリアの実体。ワークツリーのファイルパス・更新日時・パーミッション・対応するBlobのSHA-1ハッシュ値がバイナリ形式でキャッシュされている。

その他のファイルやフォルダも見てみましょう:

  • config:リポジトリ固有の設定ファイル(リモートリポジトリのURL、ブランチのトラッキング情報など。git config --local の設定先)。
  • hooks/:コミット直前(pre-commit)やプッシュ前(pre-push)に自動実行されるスクリプト置き場(Day 37で解説)。
  • info/exclude:.gitignore に書かずに、自分だけのPCローカルで除外したいファイルを指定する隠し設定ファイル。

③ 物理データの流れ:ワークツリー → indexバイナリ → objects圧縮ストア

皆さんが普段行っている「コードを書いて、git add して、git commit する」という一連の操作。このとき、.git フォルダの内部では物理的に何が起きているのでしょうか?

物理データの流れ
▲ 【図解③】物理データの流れ:ワークツリー → indexバイナリ → objects圧縮ストア

ステップ順に、その物理的な挙動を追ってみましょう:

ステップ1:ワークツリーで C# コードを編集(Program.cs)

この段階では、単なるOSのファイルシステム上での通常ファイル変更です。.git フォルダ内部にはまだ何も変化は起きていません。

ステップ2:git add Program.cs を実行した瞬間

ここが最大の驚きポイントです! 「まだコミットしていないのに、Gitはすでにファイル実体を保存する」のです!
① Gitは Program.cs の内容を読み込み、ヘッダー(blob <バイト数>\\0)を付与してSHA-1ハッシュ値(例: d670460b...)を計算します。
② そのハッシュ値の先頭2文字をフォルダ名(.git/objects/d6/)、残り38文字をファイル名(70460b...)として、ファイル内容をzlibで圧縮してディスクに保存します(これがBlobオブジェクトです)。
③ 同時に、.git/index バイナリファイルに「ファイルパス: Program.cs、ハッシュ: d670460b...」という対応関係を登録します。

ステップ3:git commit -m "feat: 初回コード" を実行した瞬間

コミットを叩いた瞬間、以下の処理が走ります:
① .git/index の情報をもとに、ディレクトリ構造のスナップショットを表すTreeオブジェクトが作成され、objects/ に保存されます。
② そのTreeへの参照、直前の親コミットハッシュ、コミット日時、コミッター情報、コミットメッセージを記録したCommitオブジェクトが作成され、objects/ に保存されます。
③ 最後に、現在作業中のブランチファイル(.git/refs/heads/main)の中に書かれている40桁のハッシュ値が、今作成された最新Commitオブジェクトのハッシュ値に書き換わります!

④ ブランチとHEADの驚くべき正体:たった41バイトのテキストファイル

SVNやVSSを使っていたエンジニアが最も誤解しやすいのが「ブランチ」です。
SVN時代のブランチは svn copy というコマンドで作られており、概念的には「プロジェクト全体のディレクトリを丸ごと別フォルダにコピーする」という極めて重たい操作でした。
そのため、「ブランチを乱発するとディスク容量を食う」「ブランチの作成や切り替えに数十秒待たされる」という強烈なトラウマをお持ちの方も多いはずです。

しかし、Gitのブランチの実体を物理ファイルとして見てみると、その常識は完全に覆ります!

refsとHEADの物理構造
▲ 【図解④】ブランチとHEADの正体:たった41バイトのプレーンテキストファイル!

PowerShellで実際のファイルの中身を Get-Content してみましょう:

PS C:\Projects\MyCSharpApp> Get-Content .git\HEAD
ref: refs/heads/main

PS C:\Projects\MyCSharpApp> Get-Content .git efs\heads\main
e4f2a71d89b3f021e8d9124508d0e729a5c88931

なんということでしょう!
.git/HEAD は、単に「今は refs/heads/main を見ています」と書かれたわずか23バイトのテキストファイルです。
そして .git/refs/heads/main は、mainブランチの先端コミットを表す40文字のハッシュ値と改行コードが書かれたわずか41バイトのテキストファイルに過ぎません!

💡 なぜ Git のブランチ作成・切り替えは一瞬(0.001秒)で終わるのか?

新しいブランチを作成する git branch feature-login とは、内部的には「.git/refs/heads/feature-login という41バイトのテキストファイルを1個ポンと作る」だけの処理です。
そしてブランチを切り替える git switch feature-login とは、「.git/HEAD の中の1行を ref: refs/heads/feature-login に書き換えて、ワークツリーをそのコミットのスナップショットに合わせる」だけの処理です。
ファイルを丸ごとコピーするのではなく、単なる**「41バイトの付箋紙(ポインタ)を動かしているだけ」**だからこそ、10万行のC#プロジェクトであっても一瞬でブランチが作れ、切り替えられるのです!

⑤ PowerShellで体験! .git 内部を覗く低レベルGitコマンド集(Plumbing)

Gitには、普段人間が使う add や commit などの「磁器コマンド(Porcelain command)」のほかに、Git内部の低レベルデータ構造を直接操作・閲覧するための「配管コマンド(Plumbing command)」が用意されています。
30年エンジニアの好奇心を刺激する、配管コマンドによる内部探索テクニックをご紹介します!

① `git cat-file -p HEAD` :最新コミットの中身をダンプする

圧縮されたコミットオブジェクトの中身を人間が読める形式で表示します:

$ git cat-file -p HEAD
tree 4b825dc642cb6eb9a060e54bf8d69288fbee4904
parent a1b2c3d4e5f60718293a4b5c6d7e8f9012345678
author Taro Yamada <taro@example.com> 1731744000 +0900
committer Taro Yamada <taro@example.com> 1731744000 +0900

feat: ユーザー認証機能の実装

▲ tree(フォルダ構造)、parent(親コミット)、作者、コミッター、コミットメッセージが綺麗に記録されているのが分かります!

② `git ls-files --stage` :ステージング(index)の中身を一覧表示する

バイナリファイルである .git/index に今何が登録されているかを確認します:

$ git ls-files --stage
100644 d670460b4b4aece5915caf5c68d12f560a9fe3e4 0 Program.cs
100644 83ba4872b3a140f0b80d3297072e390ff7e133d2 0 appsettings.json

▲ ファイル権限(100644)、BlobオブジェクトのSHA-1ハッシュ値、ステージ番号(0=通常)、ファイル名が1行ずつ管理されていることが確認できます!

📌 本日のまとめ

  • ルート1箇所の美しい集中管理:各フォルダに散らばっていたSVNと違い、Gitはルートの .git に全履歴を集約するため、作業ディレクトリが常にクリーン!
  • .git を支える4大コア要素:現在ブランチを指す HEAD、ブランチ先端コミットを保持する refs/heads/、全実データを圧縮保存する objects/、ステージングを管理する index の4つが連携!
  • add した瞬間にデータは保存される:git add でファイル実体はzlib圧縮されて objects/ にBlobとして即座に格納され、index に登録される!
  • ブランチの正体はたった41バイトの付箋紙:ブランチは重いフォルダコピーではなく、40桁のコミットハッシュが書かれたテキストファイルに過ぎないからこそ、作成も切り替えもミリ秒で超高速!

🚀 次回予告:Day 49

第10部「Git内部アーキテクチャ深掘り」の第2弾!
次回は【Gitの4大オブジェクト(Blob, Tree, Commit, Tag)とハッシュ】を徹底深掘りします!
皆さんが書いたC#のコードがどのようにBlobオブジェクトになり、ディレクトリ構造がTreeになり、コミットと結びつくのか?
Gitの有向非巡回グラフ(DAG)の正体と、SHA-1/SHA-256ハッシュによる改ざん不可能なスナップショットツリーの仕組みを完全に解き明かします。お楽しみに!

コメント

このブログの人気の投稿

【Perfume】Perfume 3rd Tour 「JPN」さいたまスーパーアリーナに行って参りました~

Perfume 3rd Tour 「JPN」1月28日、29日の2daysで参戦して参りました。 ファンクラブ会員の選考抽選会に28日、29日の両日で申し込んでいたんですが、両方とも当選していたという嬉しい誤算。 仕事だぁ、なんだかんだと紆余曲折ありまして28日の参戦は危ぶまれていたのですが、なんとかかんとか28日は40分遅刻しながらも参戦、29日はフル参戦する事が出来ました(∩´∀`)∩

Perfume、2025年末で“コールドスリープ(活動休止)”へ──東京ドーム2daysの記録と、公式・各界・ファンの声

  1) 公式発表・基本情報 活動休止(コールドスリープ)を正式発表 2025年9月21日、公式サイト「 Perfumeより 」で、2026年から一度コールドスリープに入ると発表。再始動の意思(“新しいPerfume”として戻る)も明記。 Perfume Official Site 今後の運用告知(配信・上映など) 同21日付の「 今後のPerfumeに関して 」で、9/23(火・祝)東京ドーム公演の LIVESHIP全世界生配信 および 全国ディレイビューイング 決定を案内。特設サイトも併記。 Perfume Official Site +1 公式グッズ **「Perfume Calendar 2026」**発売決定(B2壁掛け/表紙+2カ月1枚×6枚+ポスター)。テーマは“フルーツ”。 Perfume Official Site 2) 東京ドーム2days(9/22・23)要点 公演タイトル: ZO/Z5 Anniversary “ネビュラロマンス” Episode TOKYO DOME 。日程・開場/開演・会場・物販等の実務情報は特設で公開。 Perfume Official Site 9/23公演を世界配信(LIVESHIP) /ディレイビューイング実施。 Perfume Official Site 海外向け報道(英語)も「 indefinite hiatus 」として広く配信。 The Times of India 国内英字メディアも速報。 朝日新聞 3) 現地レポ( メリ爺 )から見える空気 あなたの現地記録(9/24公開)を、ファクトと現場情景の両面で反映: 両日参戦 。22日は アリーナ 、23日は 1階席から俯瞰 。前日の発表を受け、開演前のザワつき→MC後に“いつもの一体感”へ。開演は22日 18:45 頃。オープニングは**P³ツアー東京ドーム(2020/2)**と同趣向で“回収”の演出。 メリ爺のゲーム万歳 MC所感 :解散ではなく前向きな休止で不安を和らげる内容。 かしゆか の涙、 のっち の気丈さ、 あ〜ちゃん の思い出語り──3人の結束と「 また戻る 」約束が強く刻まれた。 メリ爺のゲーム万歳 体感時間 : “3時間弱”級のボリューム ながら“過去一...

ニンテンドースイッチでオンラインゲームを遊ぶには?

モンスターハンターライズが発売になって、家族でモンハン楽しみたい人が増えたみたいですね。 某ブログの検索キーワードを調べると、モンハンを家族でやるにはどうしたらいいのか?を調べている人が沢山いるのがわかります。 ※これでも一部  家族で協力するにはSwitch2台、ソフトも2つ購入する必要があります。 1台のスイッチでは遊べませんし、ソフト1つでも遊べません。 でも、1台のスイッチで別々アカウントがあれば交代で遊ぶこともできますよ。セーブデータもしっかり分かれます。 Switchのオンラインゲームを家族で遊ぶ方法については以下の記事にまとめてますのでよろしければ参考にしてみてくださいね。 家族でモンスターハンターライズDL版のオンラインプレーを楽しむ方法