はじめに
この実験では、ファイルが Git インデックス（ステージングエリアとも呼ばれます）に存在するかどうかを確認する方法を学びます。インデックスの概念と、コミットのために変更を準備する際におけるその役割を探ります。
git ls-files --stage コマンドを使用してインデックスの内容を表示し、git status コマンドを使用して、ステージングされた変更とステージングされていない変更を含むリポジトリの状態の包括的な概要を取得します。最後に、まだインデックスに追加されていないファイルを Git がどのように扱うかをテストします。
git ls-files --stage を実行する
このステップでは、Git インデックス（ステージングエリアとも呼ばれます）を探索します。インデックスは Git における重要な概念です。コミットする前に変更を準備する待機エリアのようなものです。
このように考えてみてください。作業ディレクトリ内のファイルに変更を加えた場合、それらは自動的に次のコミットに含まれるわけではありません。まず、git add を使用してインデックスに追加する必要があります。インデックスは、ステージングされた変更のスナップショットを保持しており、コミットの準備ができています。
現在インデックスにある内容を確認するには、git ls-files --stage コマンドを使用します。このコマンドは、次のコミットのために現在ステージングされているファイルを一覧表示します。
my-time-machine ディレクトリで試してみましょう。
cd ~/project/my-time-machine
git ls-files --stage
この新しいリポジトリではまだインデックスにファイルを追加していないため、出力は何も表示されないはずです。これは、インデックスが現在空であることを示しています。
インデックスを理解することは、Git を習得するための重要なポイントです。これにより、各コミットに含まれる内容を細かく制御でき、関連する変更をまとめて、コミット履歴をきれいに整理することができます。
git status を使用してインデックスを確認する
前のステップでは、git ls-files --stage を使用してインデックスの内容を確認しました。インデックスを含むリポジトリの状態を理解するのに役立つ別のコマンドが git status です。
git status コマンドは、作業ディレクトリとステージングエリアでの状況を最後のコミットと比較した概要を提供します。どのファイルが変更されたか、次のコミットのためにステージングされているファイルはどれか、また追跡されていないファイルはどれかを教えてくれます。
my-time-machine ディレクトリで git status を実行してみましょう。
cd ~/project/my-time-machine
git status
これはまったく新しいリポジトリで、まだファイルを作成したりコミットを行ったりしていないため、出力は次のようになるはずです。
On branch master
No commits yet
nothing to commit (create/copy files and use "git add" to track)
この出力は、コミットする変更がないことを確認しており、つまり git ls-files --stage が示した通り、インデックスは空です。「nothing to commit」というメッセージは、直接インデックスの状態に関係しています。
この実験を進めてファイルを作成し、ステージングするようになると、git status の出力がインデックスの内容と作業ディレクトリの状態を反映するようにどのように変化するかを見ることができます。
インデックスされていないファイルをテストする
このステップでは、作業ディレクトリに新しいファイルを作成し、それがインデックスに追加される前に Git がそれをどのように認識するかを観察します。これにより、作業ディレクトリ内のファイルとインデックス内のファイルの違いを理解するのに役立ちます。
まず、my-time-machine ディレクトリにいることを確認しましょう。
cd ~/project/my-time-machine
次に、echo コマンドを使用して簡単なテキストファイルを作成しましょう。
echo "This is a new file." > new_file.txt
このコマンドは、new_file.txt という名前のファイルを作成し、その中に「This is a new file.」というテキストを書き込みます。
では、git status を使用してリポジトリの状態を再度確認しましょう。
git status
以下のような出力が表示されるはずです。
On branch master
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
new_file.txt
nothing added to commit but untracked files present (use "git add" to track)
「Untracked files:」のセクションに注目してください。Git は、new_file.txt が作業ディレクトリに存在することを認識していますが、まだ Git によって追跡されていません。これは、そのファイルがインデックスに含まれておらず、コミット履歴の一部ではないことを意味します。
これが重要な概念です。Git は、git add を使用して明示的に追跡するように指示したファイルのみを追跡します。Git リポジトリの作業ディレクトリに作成された新しいファイルは、最初は「追跡されていない」状態になります。
次のステップでは、このファイルをインデックスに追加し、最初のコミットの準備をします。
まとめ
この実験では、ファイルが Git のインデックス（ステージングエリアとも呼ばれます）に含まれているかどうかを確認する方法を学びました。次のコミットのために現在ステージングされているファイルを直接リストするために git ls-files --stage コマンドを使用しました。また、git status コマンドを調べました。このコマンドは、ステージングされたファイル、変更されたファイル、および追跡されていないファイルに関する情報を含む、リポジトリの状態の包括的な概要を提供し、インデックスの内容を確認するのに役立ちます。
