$Git Simulator
壊しても大丈夫。全部ブラウザの中だけで動いています

.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拡張子が .txta.txt, docs/b.txt
a/*.txta の直下の .txt だけa/x.txt(a/b/x.txt は対象外)
a/**/xa 以下の何階層目かの xa/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 status

2 回目の git status で .env が消え、代わりに .gitignore が未追跡として現れるはずです。