Git差分の表示

AIエージェントが何を変更したのかを、ファイルごと、行ごとに正確に確認できます。

AIエージェントが書いた内容をコミットする前に、必ず差分を確認しましょう。かかる時間はわずか30秒ですが、壊れた変更や意図しない変更をそのままリリースしてしまう事態を防げます。Git Clientなら、すべての変更を色分けされた見やすいビューで確認できます。

差分ビューを開く

  1. Cmd+G(Mac)または Ctrl+G(Windows/Linux)を押して、Gitパネルを開きます
  2. 左サイドバーに、未コミットの変更があるすべてのファイルが一覧表示されます。未ステージの変更は下のセクションに表示されます
  3. ファイル名をクリックすると、右側にそのファイルの差分が開きます

差分ビューはすぐに開きます。余計な手順は必要ありません。

Gitのビジュアル変更差分ビュー

差分の読み方

差分は標準的な色分けで表示されます。

  • 緑の行 — エージェントが追加した行
  • 赤の行 — 削除された行、または置き換えられた行
  • グレーの行 — 編集箇所の前後にある変更されていないコンテキスト(参考用に表示されます)

変更された各セクションはハンクと呼ばれます。ファイルの複数の箇所が変更されている場合、1つのファイルに複数のハンクが含まれることがあります。下にスクロールしてすべて確認しましょう。

左側の行番号は元のファイルの行番号、右側の行番号は新しいファイルの行番号を示します。

差分からコードへジャンプする

ダブルクリックすると、変更箇所をエディタで開けます。

  • 変更されたファイルは、ファイルリスト、フォルダツリー、コミットのファイル一覧、差分ヘッダーのファイル名のいずれからでも、エディタでそのファイルが開きます。
  • 差分の行は、まさにその行にカーソルを置いた状態でファイルが開きます。追加された行と変更のない行はそれぞれの行へ、削除された行は現在その位置にある行へ、ハンクヘッダーはそのハンクの最初の行へ移動します。

統合表示とサイドバイサイド表示

差分のレイアウトは2種類から切り替えられます。

  • 統合表示(Unified) — 追加と削除を1つのカラムに交互に並べて表示します。連続した変更を読むのに向いています。
  • サイドバイサイド表示(Side-by-side) — 左に変更前のファイル、右に変更後のファイルを表示します。大きなブロックが変更された場合に、変更前後を比較しやすくなります。

差分パネルの右上にある表示切り替えボタンをクリックすると、切り替えられます。

差分ビューア

画像の差分

プロジェクトに画像が含まれていて、エージェントがPNG、JPGなどの画像ファイルを変更した場合、差分パネルには変更前後のビジュアル比較が表示されます。スライダーをドラッグすると、新しい画像の下にある古い画像が現れるため、意図しないデザイン変更を見つけるのに便利です。

キーボードナビゲーション

次のショートカットで、変更されたファイル間をすばやく移動できます。

ショートカット操作
]次の変更ファイルへ移動
[前の変更ファイルへ移動
↓ / ↑差分をスクロール

] と [ でファイルを切り替えるほうが、サイドバーをクリックするよりずっと速く、エージェントが一度に10~15個のファイルを変更した場合には特に効果的です。

なぜコミット前にレビューするのか

AIエージェントは作業が速く、たいていは正確ですが、常にそうとは限りません。差分をレビューするときに確認すべき代表的なポイントは次のとおりです。

  • 削除されるべきでない削除行 — エージェントが関数やコメントを誤って削除してしまった可能性があります
  • 依頼していないファイルの変更 — 想定していなかった設定ファイルやテストファイルにエージェントが手を加えている場合があります
  • プレースホルダーの値 — TODO、your-api-key-here、残すつもりのなかったハードコードされたテストデータなど

コミットのたびに手早く差分をレビューしておけば、Gitの履歴をきれいに保ち、コードベースを常に正常な状態に維持できます。また、エージェントが実際に何をしたのかを理解できるため、長い目で見て開発者としての成長にもつながります。