.gitignore の書き方入門|パターン記法とプリセットの選び方
公開日:2026年10月27日 更新日:2026年9月15日 運営:シルギア(アナライズギア株式会社) 対象ツール:.gitignore 生成
.gitignore は、Git にコミットしたくないファイルやフォルダを指定するための設定ファイルです。依存パッケージ(node_modules/ や vendor/)、ビルド生成物(dist/ や target/)、ログ、キャッシュ、秘密情報を含む .env などは、自動生成できたり共有すべきでなかったりするため、リポジトリに含めないのが定石です。この記事では、パターンの読み書きとプリセットの組み合わせ方を、生成ツールの実際の挙動に沿って整理します。
.gitignore が担う役割
.gitignore に書いたパターンに一致するファイルは追跡候補から外され、git status の一覧にも git add . の対象にも現れなくなります。目的は主に3つです。第一に、再生成できるもの(ビルド成果物・依存パッケージ)を履歴に残さずリポジトリを軽く保つこと。第二に、.env や鍵ファイルなど共有すると危険な情報を誤ってコミットしないこと。第三に、.DS_Store やエディタ設定など各自の環境固有で他人には不要なゴミを混ぜないことです。ファイルはリポジトリのルート(.git と同じ階層)に1つ置けば全体に効き、特定フォルダだけに効かせたいときはそのフォルダ内に別途置けます。
パターン記法を正しく読む
.gitignore の1行が1パターンです。記号の意味を押さえると、意図した範囲だけを的確に除外できます。
- * (アスタリスク):スラッシュを除く任意の文字列に一致します。*.log はすべてのログファイル、npm-debug.log* は末尾に何か付くものまでまとめて拾います。
- 行末の /:ディレクトリだけに一致します。build/ は build という名のフォルダを除外しますが、build という名前のファイルは残します。
- 先頭の /:その .gitignore がある階層からの相対パスに固定します。/vendor/ はルート直下の vendor だけを指し、深い階層の同名フォルダには効きません。逆にスラッシュを付けない node_modules/ は、どの階層の node_modules にも一致します。
- **:複数階層をまたいで一致します。**/*.rs.bk は、どんなに深い場所にある .rs.bk ファイルも対象にします。
- 行頭の !:否定(再包含)です。いったん除外した中から「これだけは含める」と戻します。
プリセットの考え方と組み合わせ方
生成ツールのプリセットは「言語・フレームワーク」と「OS・エディタ」の2系統に分かれています。前者は Node・Python・Java・PHP/Laravel・Ruby・Go・Rust など、その技術が生成する依存物やビルド成果物を、後者は macOS の .DS_Store、Windows の Thumbs.db、VSCode・JetBrains・Vim が作る設定・スワップファイルを除外します。実務での基本形は「使っている言語1つ+自分の OS +自分のエディタ」の組み合わせです。たとえば Mac で VSCode を使い Laravel を書くなら、PHP / Laravel・macOS・VSCode の3つを選べば、/vendor/ や .env、.DS_Store、.vscode/* までひととおり揃います。選んだプリセットは # === Node === のような見出し付きで結合され、どの行がどこ由来かが後から見てもわかります。
重複除去と否定行の意味
複数のプリセットを選ぶと、同じパターンが何度も登場します。たとえば node_modules/ は Node にも PHP / Laravel にも含まれ、build/ は Node・Python・Java に共通します。生成ツールはこれらを最初に登場した1回だけ残して自動除去します。カスタム追記欄の行も、すでに含まれていれば省かれるので二重になりません。ただしコメント行(# で始まる行)は重複判定の対象外で、そのまま残ります。否定行の扱いも重要です。VSCode プリセットは .vscode/* でフォルダを一括除外したうえで、!.vscode/settings.json のように設定ファイルだけを再包含します。順序が意味を持ち、除外行の後に否定行を置く必要がある点に注意してください。
よくある失敗と落とし穴
最もつまずきやすいのは、すでにコミット済みのファイルは .gitignore を書いても無視されないという点です。.gitignore は「まだ追跡していないファイル」にしか効かないため、一度 git add / git commit した .env や node_modules は、後からパターンを足しても追跡され続けます。外すには追跡だけを解除する必要があります。
- git rm --cached <ファイル> で、作業ディレクトリのファイルは残したまま追跡を解除する。
- .gitignore に該当パターンを書く。
- コミットし直す。
なお、誤って含めた秘密情報はこれだけでは過去の履歴に残るため、鍵の再発行など別の対処が要ります。もう一つがグローバル無視です。.DS_Store や自分のエディタ設定のようにどのリポジトリでも共通で無視したいものは、core.excludesfile(例: ~/.gitignore_global)へまとめると、チームの .gitignore を汚さずに済みます。
このツールでの作り方
使い方はシンプルです。まず「言語・フレームワーク」から技術をチップで選び(複数可)、続いて「OS・エディタ」で自分の環境を選びます。選択に応じて下の欄へ内容がリアルタイムに生成されます。プロジェクト固有の除外(/uploads/ や secret.key など)は「カスタム追記」欄に1行1パターンで書き足せます。仕上がったら「コピー」または「.gitignore をダウンロード」で保存し、リポジトリのルートに置きます。処理はすべてブラウザ内で完結し、入力内容はどこにも送信されません。生成結果はあくまで一般的な出発点です。たとえば Rust の Cargo.lock はアプリではコミットし、ライブラリでは除外するのが慣例です。最後はプロジェクトの事情に合わせて自分の目で調整してください。