git addコマンドの使い方を基本からオプションまで初心者にもわかりやすく解説

リンドくん

たなべ先生、Git使ってるんですけど、git addって正確には何をしているんですか？
いつも.つけて使ってるだけで...

たなべ

いい質問だね！
多くの人がgit add .だけで済ませちゃうんだけど、実はgit addには便利なオプションがたくさんあるんだよ。

今日はその実力を最大限に引き出す方法を教えるね。

ステージングエリアとは何か

Gitを使い始めたばかりの方にとって、git addコマンドは単に「変更をコミットする前の準備」程度の認識かもしれません。
しかし、このコマンドはGitのワークフローの中で非常に重要な役割を担っています。

git addコマンドの主な目的は、変更したファイルをステージングエリア（インデックス）に追加することです。
ステージングエリアとは、次のコミットに含めたい変更を準備しておく場所と考えてください。

これがなぜ重要かというと、ステージングエリアがあることで以下のメリットを享受できます。

例えば、10個のファイルを変更したとしても、関連する変更ごとに分けて複数のコミットにすることが可能です。
これにより、変更履歴が整理され、後から特定の変更を追跡しやすくなります。

基本的な使い方とよく使うオプション

基本形式

git add [オプション] [ファイル/ディレクトリのパス]

よく使うパターン

リンドくん

git addのあとにはどんなパターンがあるんですか？

たなべ

実はいろんな指定方法があるんだよ。使い分けることで作業効率がグッと上がるんだ。

特定のファイルを追加

git add ファイル名

例:

git add index.html

複数の特定ファイルを追加

git add ファイル1 ファイル2 ファイル3

例:

git add index.html style.css script.js

すべての変更を追加

git add .

カレントディレクトリ以下のすべての変更をステージングします（新規ファイル、変更ファイル、削除ファイル）。

変更と削除を追加（新規ファイルは除く）

git add -u

すでにGitの管理下にあるファイルの変更と削除のみをステージングします。
新しく作成したファイルは追加されません。

すべてのファイルを追加（非管理ファイルも含む）

git add -A

または

git add --all

リポジトリ内のすべての変更をステージングします。
ただし、.gitignoreで指定されたファイルは除外されます。

選択的なステージングとインタラクティブモード

リンドくん

1つのファイルの一部の変更だけをコミットしたいときってどうすればいいんですか？

たなべ

それにはインタラクティブモードが超便利なんだよ！
ファイルの特定の部分だけを選んでステージングできるからね。

パッチモード（変更の一部だけを追加）

git add -p

または

git add --patch

このコマンドを実行すると、変更された各「hunk（ハンク=変更のかたまり）」ごとにステージングするかどうかを対話的に選択できます。

表示されるプロンプトでは、以下のような選択肢が表示されます。

これにより、ファイルの特定部分だけをコミットに含めることができ、関連性のある変更を論理的にグループ化できます。

インタラクティブモード

git add -i

または

git add --interactive

こちらはより高度な対話モードで、ステージング、アンステージング、パッチの適用など、様々な操作をメニューから選択できます。

知っておくと便利な特殊なオプション

ドライラン（実際には追加せずに確認）

git add -n

または

git add --dry-run

このオプションを使うと、実際にはステージングせずに、何が追加されるかを確認できます。
大量のファイルがある場合や、ワイルドカードを使用する場合に、予期しない結果を避けるために便利です。

変更されたファイルのみ（新規ファイルは無視）

git add -u

または

git add --update

既にGitで管理されているファイルの変更と削除のみをステージングします。

強制的に追加（.gitignoreを無視）

git add -f ファイル名

または

git add --force ファイル名

.gitignoreで指定されていて通常は無視されるファイルを強制的にステージングします。
設定ファイルなど、特別な場合に使用します。

実践的なワークフローでの使い方

リンドくん

実際のプロジェクトではどう使い分けるのがベストなんでしょうか？

たなべ

その状況によって最適な使い方は変わるんだ。ケースごとに見ていこうか。

シナリオ1. 特定の機能に関連する変更だけをコミット

複数の機能を同時に開発していて、特定の機能に関連するファイルだけをコミットしたい場合は以下のような流れです。

git add src/components/feature1/*
git add src/tests/feature1/*
git commit -m "Add feature1 implementation and tests"

シナリオ2. 修正したバグに関連するファイルだけをコミット

git add -p
# 関連する変更だけを「y」で選択
git commit -m "Fix login validation bug"

シナリオ3. 一時的な設定変更を除外してコミット

開発中に一時的に変更した設定ファイルを除外してコミットする場合は以下の流れです。

git add .
git reset -- config.development.js
git commit -m "Update user authentication logic"

git addを使う際の注意点とベストプラクティス

大事なコミットの前には変更内容を確認

コミット前に、何をステージングしたか確認するのは身に着けるべき習慣です。

git status
git diff --staged  # ステージングされた変更を表示

意図しないファイルの追加を避ける

.gitignoreファイルを適切に設定して、ビルド成果物やログファイルなど、リポジトリに含めるべきでないファイルが追加されないようにしましょう。

コミットは論理的にまとめる

一つのコミットには、一つの論理的な変更（機能追加、バグ修正など）のみを含めるようにしましょう。
そのためには、git addを使って関連する変更だけを選択的にステージングすることが重要です。

まとめ

リンドくん

知らなかったオプションがたくさんありましたね！特にパッチモードは使ってみたいです。

たなべ

そうだね！
git addを使いこなせると、コミット履歴がきれいになって、チーム開発もスムーズになるよ。ぜひ色々試してみてね。

git addコマンドは、一見シンプルですが、適切に使いこなすことで開発ワークフローを大きく改善できる強力なツールです。

最も重要なポイントは以下の通りです。

ぜひ今回紹介したオプションを実際に試してみて、あなたのGitワークフローを次のレベルに引き上げてください。
特に-p（パッチ）オプションは、きめ細かい変更管理に非常に役立ちます。

日々の開発作業において、適切なコミット粒度を保つことは、後から変更を追跡する際や、チームでのコードレビューの際に大きな違いを生みます。
git addコマンドのオプションを使いこなして、より効率的で整理された開発プロセスを実現しましょう。