.gitignore ルールテスター

このツールについて

ルートの .gitignore 1つと改行区切りのサンプルパスを貼り付け、リポジトリを開かずにルールの効果を確認できます。結果では除外、明示的な除外解除、ルールに未一致、無効なパスを区別し、親ディレクトリから継承した除外も含めてルールの行で根拠を示します。固定バージョンの ignore 7.0.12 を使い、大文字・小文字を区別して UTF-8 バイト単位でローカル照合します。ファイルシステムの読み取りや Git の実行は行いません。

実行して確かめられるルールとパス

{
  "rules": "*.log\n!important.log\nprivate/*.log",
  "paths": "debug.log\nimportant.log\nprivate/important.log\nREADME.md"
}

{
  "statuses": [
    "ignored",
    "unignored",
    "ignored",
    "unmatched"
  ]
}

{
  "rules": "build/\n!build/keep.txt",
  "paths": "build/\nbuild/keep.txt\nbuild/output.js\nsrc/main.js"
}

{
  "statuses": [
    "ignored",
    "ignored",
    "ignored",
    "unmatched"
  ]
}

{
  "rules": "/cache/\n*.tmp",
  "paths": "cache/\ncache/data.json\napp/cache/data.json\napp/draft.tmp\nDRAFT.TMP"
}

{
  "statuses": [
    "ignored",
    "ignored",
    "unmatched",
    "ignored",
    "unmatched"
  ]
}

{
  "rules": "docs/**/draft?.md",
  "paths": "docs/draft1.md\ndocs/a/b/draft2.md\ndocs/draft10.md\nother/docs/draft1.md"
}

{
  "statuses": [
    "ignored",
    "ignored",
    "unmatched",
    "unmatched"
  ]
}

{
  "rules": "# comment\n\\#draft\n\\!todo\nnote\\ ",
  "paths": "#draft\n!todo\nnote \nnote\n note"
}

{
  "statuses": [
    "ignored",
    "ignored",
    "ignored",
    "unmatched",
    "unmatched"
  ]
}

{
  "rules": "a/*",
  "paths": "a/\na\na/file.txt"
}

{
  "statuses": [
    "ignored",
    "unmatched",
    "ignored"
  ]
}

{
  "rules": "x?y\nx??y",
  "paths": "xay\nxéy\nx😀y"
}

{
  "statuses": [
    "ignored",
    "ignored",
    "unmatched"
  ]
}

{
  "rules": "*.tmp",
  "paths": "/tmp/cache.tmp\nC:/cache.tmp\nsrc\\cache.tmp\n./cache.tmp\n../cache.tmp\nsrc//cache.tmp\nsrc/../cache.tmp\nsrc/cache.tmp"
}

{
  "statuses": [
    "invalid",
    "invalid",
    "invalid",
    "invalid",
    "invalid",
    "invalid",
    "invalid",
    "ignored"
  ]
}

よくある除外ルールのテストミス

• シェルの glob、正規表現、Windows のバックスラッシュを .gitignore のパス構文として使うこと。
• !child/path で除外された親を再び開けると思うことや、unmatched を明示的な例外と読むこと。
• サンプルパスの空白を削る、引用符を付ける、ディレクトリを表す末尾 / を忘れること。
• ? が見た目の Unicode 文字数を数えると考えたり、独立した ** セグメントの代わりに *** や埋め込んだ ** を使ったりすること。
• 除外の結果を追跡済みファイルや秘密情報の削除の証拠と考えたり、未編集のレポートを確認せず共有したりすること。

制限と注意事項

• —評価するのは貼り付けたルート .gitignore のみです。入れ子の .gitignore、.git/info/exclude、グローバル除外、リポジトリ設定、追跡済みファイルの状態は読み取りません。除外判定で追跡済みファイルを取り除くことはできず、Git 履歴に秘密情報がないことも保証しません。シンボリックリンクのサンプルはファイルとして扱い、リンクの追跡やディレクトリの走査は行いません。
• —パスは大文字・小文字を区別する POSIX 形式の / 区切りです。絶対パス、ドライブ接頭辞、バックスラッシュ、. と .. のセグメント、内部の空セグメント、NUL、ASCII 制御文字、不正な Unicode は拒否します。サンプルパスの前後の空白はそのまま保持し、空行はスキップします。LF と CRLF に対応します。ルールはコメント、先頭 # と ! のエスケープ、否定、*、?、文字クラス、独立した ** セグメントに対応します。*** やセグメントの一部である ** は曖昧なため拒否し、推測で処理しません。ルール内の ASCII 制御文字や不正な Unicode も受け付けません。
• —ルールは UTF-8 で32 KiB、物理行数200行、1行あたり256 UTF-16 コード単位までです。パス入力は合計32 KiB、物理行数100行、1パスあたり512 UTF-16 コード単位までです。空行とルールのコメントも行数に含み、最後の改行は追加の1行に数えません。全体の上限超過や未対応のルールではテストを停止し、個別の無効なパスは invalid の行として表示します。 照合処理は 2,000,000 ステップが上限です。複雑なルールとパスの組み合わせは入力サイズの上限より先にこの制限に達する場合があります。入力を減らして再試行してください。部分結果は保持しません。
• —照合は表示上の文字数ではなく UTF-8 のバイト単位です。é には ? が2個、多くの絵文字には4個必要です。末尾 / は完全な走査ではなく git check-ignore path/ と同様のディレクトリ照会を表します。a/* は a/ 自体にも一致しますが、a/*/ と a/**/ は子孫ディレクトリを必要とします。後の子パスの否定ルールは除外済みの親を越えられないため、先に親を再包含してください。
• —処理は読み込み済みのブラウザページ内で行い、入力評価のためのリポジトリ、ファイルシステム、ネットワークへのアクセスはありません。プレーンテキストレポートには無効なパスも含め、元のパスとルールが秘密情報を伏せずに入ります。絞り込みや表示ページにかかわらず全行を出力し、引用符付き文字列で空白を保ち、改行をエスケープします。コピー、ダウンロード、共有の前にプロジェクト名、非公開のファイル名、認証情報を確認してください。保存またはコピー後のレポートはページの管理外です。

よくある質問

関連ツール