すでにコミットされたファイルを Git の管理対象から外す方法

Git の仕様として、.gitignore はまだ Git に登録されていない「未追跡ファイル (Untracked files)」に対してのみ効果を発揮します。過去に一度でも git add および git commit を実行したファイルは、Git のインデックス（ステージングエリア）に記録され、管理対象（Tracked）となっています。

そのため、後から .gitignore にファイル名やパターンを記述しても、Git は自動的にそのファイルの追跡を停止しません。.gitignore の除外ルールを反映させるには、ローカルディスクの実ファイルを残したまま、Git のインデックスからのみ削除（追跡解除）する操作が必要です。

git rm コマンドに --cached オプションを付けることで、ローカルの物理ファイルを削除せずに Git のインデックスからのみファイルを安全に除外できます。

# 1. .gitignore に該当ファイルが記載されていることを確認
echo ".env" >> .gitignore

# 2. Git のインデックスからのみ削除（ローカルの実ファイルは保持）
git rm --cached .env

# 3. 追跡解除をコミット
git commit -m "Stop tracking .env file"

build/ や node_modules/ など、フォルダ全体が誤ってコミットされている場合は、再帰的に処理を行う -r オプションを併せて指定します。

# 1. .gitignore にフォルダ除外ルールを追加
echo "build/" >> .gitignore

# 2. ディレクトリ全体を Git のインデックスから再帰的に削除
git rm -r --cached build/

# 3. 変更をコミット
git commit -m "Stop tracking build/ output directory"

.gitignore を後から本格的に作成し、多数のファイルがすでにコミットされている場合は、一度インデックスの追跡キャッシュを全てクリアして再登録するのが最も確実です。

# 1. 作業中の変更がすべてコミットまたは stash されていることを確認
git status

# 2. Git インデックスの追跡キャッシュを一旦すべてクリア
git rm -r --cached .

# 3. .gitignore のルールを適用してファイルを再追加
git add .

# 4. キャッシュの再構築をコミット
git commit -m "Refresh repository tracking to match .gitignore"

.env などの機密ファイルや設定ファイルを追跡解除して push する際は、事前にチームへ連絡し、設定テンプレートとして .env.example などを共有しておくことを推奨します。