.gitignore を使いこなす
.gitignore は「このファイルは Git で管理しない」と宣言するためのファイルです。ここでは書き方のルールと、よくあるつまずきを整理します。
なぜ必要か
リポジトリに入れるべきでないファイルは、意外とたくさんあります。
| 種類 | 例 | 入れない理由 |
|---|---|---|
| 依存パッケージ | node_modules/, vendor/, .venv/ | package.json などから再生成できる。巨大 |
| ビルド成果物 | dist/, build/, *.class, *.o | ソースから作り直せる。差分がノイズになる |
| 秘密情報 | .env, *.pem, credentials.json | 漏れると悪用される |
| ログ・キャッシュ | *.log, .cache/, __pycache__/ | 実行のたびに変わる |
| OS・エディタの個人ファイル | .DS_Store, Thumbs.db, .idea/ | 人によって違う。チームには無関係 |
無視しておけば git status が静かになり、git add . でうっかり入れてしまう事故も防げます。
置き場所
.gitignore は普通、リポジトリの一番上 に置いてコミットします。サブフォルダに置くと、そのフォルダ以下にだけ効きます。
my-app/
├── .gitignore ← リポジトリ全体に効く
├── src/
└── docs/
└── .gitignore ← docs/ の中だけに効くパターンの書き方
1 行に 1 パターン。基本はファイル名のワイルドカードです。
# 「#」で始まる行はコメント
# ファイル名(どの階層にあっても一致)
.DS_Store
# * は「/ 以外の任意の文字列」
*.log
# 末尾の / は「フォルダだけ」に一致
node_modules/
# 先頭の / は「.gitignore と同じ階層だけ」
/config.local.json
# ** は「何階層でも」
logs/**/*.txt
# ! は「やっぱり無視しない」(否定)
*.env
!example.envルールのまとめ
| 書き方 | 意味 | 一致する例 |
|---|---|---|
foo | どの階層の foo でも(ファイルでもフォルダでも) | foo, src/foo |
foo/ | どの階層の フォルダ foo でも | foo/a.txt, src/foo/b.txt |
/foo | 一番上の foo だけ | foo(src/foo は対象外) |
*.txt | 拡張子が .txt | a.txt, docs/b.txt |
a/*.txt | a の直下の .txt だけ | a/x.txt(a/b/x.txt は対象外) |
a/**/x | a 以下の何階層目かの x | a/x, a/b/c/x |
? | 任意の 1 文字 | file?.txt → file1.txt |
!pattern | 直前までの無視を取り消す |
途中に / を含むパターン(a/*.txt など)は、.gitignore の場所を基準にした相対パスとして扱われます。
否定(!)の落とし穴
親フォルダごと無視されていると、中のファイルを ! で救い出せません。 Git はフォルダを無視すると中身を見に行かないからです。
# ✗ これでは logs/keep.txt も無視されたまま
logs/
!logs/keep.txt
# ○ フォルダではなく「中身」を無視してから救う
logs/*
!logs/keep.txtよくあるつまずき
書いたのに無視されない
一度コミットしたファイルは、あとから .gitignore に書いても追跡され続けます。 .gitignore が効くのは「まだ追跡されていないファイル」だけです。追跡をやめるには:
git rm --cached .env # ファイルは手元に残し、追跡だけ外す
git rm -r --cached dist/ # フォルダなら -r
git commit -m ".env を追跡対象から外す"次のコミット以降は無視されます。ただし 過去のコミットには残っています。秘密情報の場合はキーやパスワードを無効化(再発行)してください。
なぜ無視されているのか分からない
本物の Git では、どの行が効いているかを調べられます。
git check-ignore -v path/to/file
# .gitignore:3:*.log path/to/file ← 3 行目の *.log が原因無視されているファイルの一覧は git status --ignored で見られます。
空のフォルダを残したい
Git は ファイル を管理するので、空のフォルダはコミットできません。慣習として .gitkeep という空ファイルを置きます(Git の機能ではなく、ただの名前の約束です)。
uploads/*
!uploads/.gitkeepチーム用と自分用を分ける
.gitignore はチームで共有するものです。自分の環境だけの事情 は別の場所に書くのがマナーです。
| 場所 | 共有される? | 向いているもの |
|---|---|---|
.gitignore | される(コミットする) | ビルド成果物、依存、.env など全員に共通のもの |
.git/info/exclude | されない | このリポジトリだけの個人的なメモファイルなど |
| グローバル設定 | されない | .DS_Store や自分のエディタの設定など、全リポジトリ共通の個人ファイル |
グローバルな無視ファイルは次のように設定します。
git config --global core.excludesFile ~/.gitignore_globalテンプレートを使う
言語やフレームワークごとに「無視すべきもの」はだいたい決まっています。GitHub の github/gitignore にテンプレート集があり、GitHub でリポジトリを作るときにも選べます。Vite や Next.js などのプロジェクト作成コマンドも、たいてい最初から .gitignore を用意してくれます。
シミュレーターで試す
このシミュレーターも簡単な .gitignore に対応しています(*・?・末尾 /・先頭 /)。否定 ! や ** には対応していません。
echo "secret" > .env
git status
echo ".env" > .gitignore
git status2 回目の git status で .env が消え、代わりに .gitignore が未追跡として現れるはずです。