HOWTO · Git

Git にファイルとフォルダーを再帰的に追加する

このチュートリアルでは、git add コマンドを使用して、Git でファイルとフォルダーを再帰的に追加する方法を説明します。

このページの内容

Gitは、次のコミットの準備に使う領域であるインデックスに、ファイルの変更をステージします。ネストされたディレクトリ内のファイルも含めるには、リポジトリ全体またはディレクトリのパスとともに git add を使います。このコマンドは変更をステージするもので、コミットを作成したり、リモートリポジトリに送信したりはしません。

git add でファイルを再帰的にステージする

git add にディレクトリのパスを指定すると、Gitはそのパス以下にある対象の変更を、サブディレクトリ内のファイルも含めてステージします。作業ツリー全体の変更をステージするには git add -A を、現在のディレクトリ以下の変更をステージするには git add . を使うこともできます。これらのコマンドに再帰用のオプションを別途指定する必要はありません。

実行場所とパスの範囲が重要です。サブディレクトリから実行したコマンドは、そのコマンドで指定される範囲のパスだけを対象にします。リポジトリ全体をステージする場合はリポジトリのルートを選び、範囲を絞る場合はディレクトリを指定してください。意図的に上書きしない限り、ignoreルールは未追跡ファイルに適用されます。

リポジトリのルートからすべての変更をステージする

リポジトリ全体の変更をステージするには、まずリポジトリのルートディレクトリに移動し、git add -A を実行します。このコマンドは、作業ツリー全体の追加、変更、削除をステージします。プロジェクト内の複数の場所に変更があり、それらをまとめて選択したい場合に便利です。

次の自己完結型の例は、Gitをインストールしたシェルで実行してください。一時的なリポジトリを作成し、ネストされたファイルを2つ追加して、ルートから変更をステージした後、簡潔なステータスを表示します。スクリプトの終了時に一時ディレクトリは削除されます。

このセクションのコードと表示されるラベルや出力は英語のままです。

work_dir="$(mktemp -d)"
trap 'rm -rf "$work_dir"' EXIT
cd "$work_dir"
git init -q
mkdir -p src/lib
printf 'app\n' > README.md
printf 'module\n' > src/lib/module.txt
git add -A
git status --short

現在のディレクトリ以下の変更だけをステージしたい場合は、git add . を使います。リポジトリのルートから実行した場合、通常は git add -A と同じ作業ツリーパスが対象になります。サブディレクトリから実行すると、git add . の対象はそのディレクトリと配下に限られますが、git add -A はリポジトリ全体の変更をステージします。リポジトリ全体を確実に対象にするには、ルートで git add -A を実行してください。

特定のディレクトリをステージする

ステージする範囲をプロジェクト内の一部に絞るには、リポジトリのルートから git add path/to/directory/ を実行し、例のパスを対象のディレクトリに置き換えます。Gitはそのパス以下にある対象の追加・変更ファイルを含めます。ディレクトリを指定すると、その中で削除された追跡済みファイルもステージされるため、インデックスに削除が反映されます。

作業ツリーの別の場所に関係のない変更がある場合は、このように範囲を絞ると便利です。ステージする前に、パスが意図したディレクトリを指していることを確認してください。git add は選択した変更をインデックスに記録するもので、ディレクトリの別コピーを作るわけではありません。ファイルを1つだけステージする場合は、そのファイルのパスを指定します。

ignore対象のファイルを扱う

.gitignore ファイルでは、通常のステージングから除外する未追跡パスをGitに指定します。たとえば *.log のようなパターンを使うと、生成されたログファイルを git add -A、git add .、およびディレクトリ単位のステージングから除外できます。ignoreルールは、ビルド出力、ローカル設定など、コミットに含めないファイルに役立ちます。

ignore対象のファイルを追跡対象にする場合は、まず無視されている理由を確認し、そのパスを git add -f path/to/file で明示的にステージします。強制オプションは、指定したパスに対してignoreルールを上書きします。そのファイルをリポジトリに含める必要がある場合に限って使ってください。生成物や個人情報を含むファイルを強制的にインデックスへ追加すると、意図しない内容を公開するおそれがあります。また、.gitignore にパターンを追加しても、Gitがすでに追跡しているファイルは追跡対象から外れません。

コミット前にステージ済みの変更を確認する

ステージした後に git status を実行すると、どのパスがステージ済みか、ステージされていない変更が残っているかを確認できます。簡潔に表示するには git status --short を使います。ステータスの1列目はステージ済みのパス、2列目はステージされていない変更を示します。特にリポジトリ全体をステージした後は、コミットする前に一覧を確認し、ignore対象や無関係なファイルが含まれていないことを確かめてください。

ステージングはコミットの準備にすぎません。コミットはステージ済みのスナップショットをローカルリポジトリの履歴に記録し、プッシュは別の操作としてコミットをリモートに送信します。コミットもプッシュもせずに再帰的なステージングを行えます。また、コミット前に意図したパスをステージし直して、インデックスを調整することもできます。