Gitignore ワイルドカードと Glob パターンガイド

gitignore はシェルのグロビングに似たパターン構文を使用しますが、重要な違いがあります。ワイルドカードを理解することが、間違ったファイルを誤って除外・包含しない正確で保守しやすい無視ルールを書くための鍵です。

*** ワイルドカード（単一レベル）：**

* はスラッシュ（/）以外の任意の文字にマッチします。単一のディレクトリレベル内でのみ動作します。

• *.log — カレントディレクトリとすべてのサブディレクトリの error.log、debug.log にマッチ。
• build/* — build/ 直下のファイルにマッチしますが、build/sub/dir/ 内のファイルにはマッチしません。
• *.py[cod] — 文字クラスと組み合わせて .pyc、.pyo、.pyd ファイルを1つのパターンでマッチ。

**** ワイルドカード（ディレクトリ横断）：**

** は0個以上のディレクトリにマッチします。利用可能な最も強力な glob パターンです：

• **/logs — ツリー内のどこにでもある logs ディレクトリにマッチ（logs/、src/logs/、a/b/c/logs/）。
• logs/** — logs/ ディレクトリ内のすべてに任意の深さでマッチ。
• **/logs/** — ツリー内のどこにでもある logs/ ディレクトリ内のすべてにマッチ。
• a/**/b — a/b、a/x/b、a/x/y/b などにマッチ。

? ワイルドカード：

? は（/ 以外の）正確に1文字にマッチします：

• file?.txt — file1.txt、fileA.txt にマッチしますが、file10.txt にはマッチしません。

文字範囲 [...]：

• *.[oa] — .o と .a ファイル（C のオブジェクトファイルとアーカイブ）にマッチ。
• temp[0-9].log — temp0.log から temp9.log にマッチ。
• [Dd]ebug/ — 大文字小文字の柔軟性のために Debug/ と debug/ の両方にマッチ。

末尾スラッシュ（ディレクトリマッチング）：

末尾の / はパターンがディレクトリのみにマッチすることを意味します：

• build/ — build ディレクトリとその中のすべてを無視。
• build（スラッシュなし） — build という名前のファイルとディレクトリの両方を無視。

先頭スラッシュ（ルート相対）：

先頭の / はパターンをリポジトリルートに固定します：

• /build — リポジトリルートの build のみを無視、src/build は無視しない。
• build（先頭スラッシュなし） — ディレクトリツリーのあらゆるレベルの build を無視。

特殊文字のエスケープ：

バックスラッシュでリテラルの特殊文字にマッチ：\# は # で始まるファイルに、\! は ! で始まるファイルにマッチします。

パフォーマンスのヒント： 具体的なパターン（例: /node_modules/）は広いワイルドカード（例: **/node_modules/）よりも高速です。git がディレクトリの走査をスキップできるためです。無視するパスが常にリポジトリルートにある場合は先頭スラッシュを使用してください。