Git のステータス: リポジトリの検査

git status は比較的シンプルなコマンドです。このコマンドは、git add と git commit の実行結果を表示します。ステータスメッセージには、ステージングされたファイルとステージングされていないファイルの関連情報も含まれます。以下のサンプル出力には、git status を実行したときの 3 つの主要カテゴリーが示されています。

追跡対象外のファイルには通常 2 つの種類があります。ひとつはプロジェクトに追加されたばかりでまだ一度もステージされたことがないファイル、もうひとつは .pyc、.obj、.exe 等の拡張子を有するコンパイル済みバイナリ ファイルです。前者については git status コマンドの出力に含めることは有用ですが、後者は作業ディレクトリの状況確認の邪魔になる場合があります。

このため Git では、.gitignore という名称の特殊ファイルにパスを記述することによって、ファイルを表示対象から完全に除外できるようにしています。除外するファイルは、1 行に 1 つずつ記述する必要があります。またワイルドカードとして、* 記号を使用できます。例えば、次の行をプロジェクトのルートにある .gitignore ファイルに追加すると、コンパイル済みの Python モジュールが git status に表示されなくなります。

The first status output will show the file as unstaged. The git add action will be reflected in the second git status, and the final status output will tell you that there is nothing to commit—the working directory matches the most recent commit. Some Git commands (e.g., git merge) require the working directory to be clean so that you don't accidentally overwrite changes.

ログ出力は、単にコミット履歴にフィルターをかけるだけの表示から完全にユーザー定義形式による表示まで、様々なカスタマイズが可能です。git log コマンドの一般的な設定例を以下に示します。

コミット履歴全体をデフォルトの形式で表示します。出力表示が 2 ページ以上にわたる場合は Space キーでスクロールが可能です。終了する場合は q を入力します。

表示するコミット数を で制限します。例えば git log -n 3 とすると、表示するコミット数は 3 です。

各コミットを 1 行にまとめます。これは、プロジェクト履歴のハイレベルの概要を取得するのに便利です。

通常の git log 情報に加えて、改変されたファイルおよびその中での追加行数と削除行数を増減数で表示します。

各コミットを表すパッチを表示します。これは、各コミットの完全な差分を表示します。プロジェクト履歴で取得可能な最も詳細なビューです。

Search for commits by a particular author. The ＜pattern＞ argument can be a plain string or a regular expression.

Search for commits with a commit message that matches ＜pattern＞, which can be a plain string or a regular expression.

と の間に位置するコミットのみを表示します。2 個の引数には、コミット ID、ブランチ名、HEAD、その他任意のリビジョン リファレンスを使用できます。

指定されたファイルを含むコミットのみを表示します。これは、特定のファイルの履歴を確認する簡単な方法です。

考慮すべきいくつかの役立つオプションがあります。--graph フラグを指定すると、コミットメッセージの左側にテキストベースのコミットの図が描画されます。--decorate はブランチの名前または表示されるコミットのタグを追加します。--oneline は、一目で簡単にコミットを参照できるように単一行にコミット情報を表示します。

5. このファイルのステータスを確認します。

ほとんどの情報は直観的に理解できますが、最初の行には説明が必要でしょう。commit に続く 40 文字からなる文字列は、コミット内容の SHA-1 チェックサムです。チェックサムには 2 つの目的があります。1 つは、コミットの完全性を保証することです。コミットが破損している場合、異なるチェックサムが生成されます。もう 1 つは、各コミットの一意の ID を提供することです。

この ID を git log .. のようにコマンド内で使用すると、特定のコミットを参照できます。例えば、git log 3157e..5ab91 を実行すると、ID が 3157e と 5ab91 の間に収まるすべてのコミットが表示されます。また、個々のコミットを参照する一般的な方法として、チェックサム以外に、ブランチ名 (ブランチの章をご覧ください) と HEAD キーワードを使用することもできます。HEAD は、ブランチであるか特定のコミットであるかを問わず、常に現在のコミットを参照します。

~ 文字は、親コミットへの相対参照を行う場合に便利です。例えば、3157e~1 は 3157e の 1 世代前のコミットを参照し、HEAD~3 は現在のコミットの「曽祖父母」 (3 世代前) にあたるコミットを意味します。

使用法のセクションでは、git log の用例を多数説明しましたが、ひとつのコマンドに複数のオプションを組み合わせて指定できることに留意してください:

このコマンドを実行すると、John Smith がファイル hello.py に加えたすべての変更のすべての差分が表示されます。

..構文は、ブランチを比較する場合に便利です。次の例は、some-feature ブランチにあって main ブランチにはないすべてのコミットの概要を表示します。