Skip to content
技術ドキュメント&リファレンス

.gitignore 技術ガイド&リファレンス

Git ignore ファイルの構文ルール、ワイルドカードの仕組み、トラブルシューティングを体系的に解説。

.gitignore 技術ガイド&リファレンス

よくある質問 (FAQ)

.gitignore の書き方、キャッシュ削除、リポジトリ管理に関するエンジニアの疑問に回答します。

.gitignore に書いたのに変更が検知され続けるのはなぜですか?

.gitignore はこれから新しく追加される未追跡ファイルにのみ作用します。すでにコミット済みのファイルは、'git rm --cached <ファイル名>' でインデックスから除外するまで追跡され続けます。

どの除外ルールがファイルに適用されているか調べるにはどうすればいいですか?

'git check-ignore -v <ファイルパス>' コマンドを実行してください。マッチしている .gitignore ファイル名と行番号が出力されます。

フォルダを除外した後に !folder/file.txt を書いても反映されないのはなぜですか?

Git は親フォルダが除外されていると、内部の走査をスキップするためです。'folder/*' のようにフォルダ配下の要素を除外した上で '!folder/file.txt' を指定する必要があります。

.gitignore において build と build/ の違いは何ですか?

'build/' はディレクトリのみにマッチします。スラッシュのない 'build' は通常ファイルとディレクトリの両方にマッチします。

Git で空のディレクトリを管理するにはどうすればよいですか?

Git は空ディレクトリを追跡できないため、フォルダ内に .gitkeep という空ファイルを配置し、'folder/*' で中身を除外した上で '!folder/.gitkeep' を例外指定するのが標準的な手法です。

.DS_Store や .vscode などの個人用ファイルをチームに影響を与えずに除外するには?

'git config --global core.excludesFile ~/.gitignore_global' を使用してグローバル除外設定を作成してください。共有リポジトリを汚さずに自分専用の除外設定が可能です。