.gitignoreに書いたのに除外されないときの調べ方:追跡済みファイルと除外ルールを確認する
作成日:2026.11.20
.gitignoreに追加したファイルが変更一覧に残るとき、`git ls-files`と`git check-ignore -v`を使って原因を調べる方法を紹介します。追跡済み・ルール不一致・`!`による除外の打ち消しを出力例で見比べ、`git rm --cached`で手元のファイルを残したまま追跡を外す手順も解説します。
生成物のパスを.gitignoreに書いたのに、git statusやエディターの変更一覧に出てくることがあります。こういうときは、まず対象のファイルがすでにGitで追跡されているかを確認します。
追跡状態はgit ls-files、除外ルールはgit check-ignore -vで調べられます。ダミーのファイルを使って、コマンドの出力を見比べてみます。
まずgit ls-filesで追跡状態を確認する
.gitignoreの除外ルールは未追跡のファイルに適用されます。すでに追跡しているファイルは、ルールに一致していても変更一覧に出てきます。
リポジトリのルートで、tracked.logを調べる例です。実際に使うときは、調べたいファイルのパスに置き換えてください。
git ls-files -- tracked.log
パスが表示されたら、そのファイルはインデックス(次のコミットに入る内容を準備する場所)に登録されています。コミット前にステージしたファイルもここに出ます。
git check-ignore -vで、どのルールに一致したかを見る
続いて、除外ルールを確認します。-vを付けると、ルールを書いたファイル、行番号、パターン、調べたパスが表示されます。.git/info/excludeやユーザー共通の除外設定に一致した場合も、出力から設定元をたどれます。
git check-ignore -v -- generated.log
通常、このコマンドでは追跡済みのファイルは表示されません。追跡を外した場合にどのルールに一致するかを確認するには、インデックスを参照せずに調べる--no-indexを付けます。
git check-ignore -v --no-index -- tracked.log
ダミーのログファイルで出力を比べる
WindowsのPowerShell 7.6.10とGit 2.56.1.windows.1で確認しました。試す場合は、検証用のリポジトリでtracked.logだけをコミットしてから編集し、未追跡のgenerated.log、keep.log、notes.txtを作ります。ルートの.gitignoreは次の2行です。
*.log
!keep.log
対象の4ファイルだけに絞って変更一覧を表示します。
git status --short -- tracked.log generated.log keep.log notes.txt
M tracked.log
?? keep.log
?? notes.txt
2列目のMは、追跡済みのファイルに未ステージの変更があることを表します。??は未追跡です。generated.logは除外されているため、ここには出ません。
git check-ignore -v -- generated.log keep.log notes.txt tracked.log
.gitignore:1:*.log generated.log
.gitignore:2:!keep.log keep.log
generated.logは1行目の*.logに一致して除外されます。keep.logは2行目の!keep.logで除外が打ち消されています。-vでは、このように除外されなかったパスも、先頭に!が付いたパターンとともに出力されます。notes.txtに一致するルールはありません。tracked.logも出力されませんが、こちらは追跡済みです。--no-indexを使うと、1行目の*.logに一致することを確認できます。
確認結果に応じて対処する
notes.txtのようにルールに一致しない場合は、パターンや.gitignoreの置き場所を見直します。この例でルートのnotes.txtだけを除外するなら、ルートの.gitignoreに/notes.txtを追加します。keep.logも除外したいなら、この例では!keep.logの行を削れば*.logが適用されます。変更後はgit check-ignore -vとgit statusで確認します。
tracked.logのように追跡済みで、今後はリポジトリに含めないと決めた場合は、git rm --cachedでインデックスから外します。--cachedを付けると、手元のファイルを残したまま、次のコミットでの削除がステージされます。
git rm --cached -- tracked.log
git status --short -- tracked.log
Test-Path -LiteralPath tracked.log
rm 'tracked.log'
D tracked.log
True
git status --shortの先頭列にあるDは、削除がステージされたことを表します。PowerShellのTest-PathはTrueなので、手元のファイルは残っています。ここでgit check-ignore -v -- tracked.logを実行すると、今度は通常の指定で*.logに一致することを確認できます。
この削除をコミットしても、過去のコミットにはファイルが残ります。認証情報をすでにコミットしていた場合は、認証情報の失効や再発行も必要です。
コミットや変更の確認手順は、Codexを使い始めた人向けGitHub入門も参考にしてください。
参考資料
奈良市を拠点に、27年以上の経験を持つフリーランスWebエンジニア、阿部辰也です。
これまで、ECサイトのバックエンド開発や業務効率化システム、公共施設の予約システムなど、多彩なプロジェクトを手がけ、企業様や制作会社様のパートナーとして信頼を築いてまいりました。
【制作会社・企業様向けサポート】
Webシステムの開発やサイト改善でお困りの際は、どうぞお気軽にご相談ください。小さな疑問から大規模プロジェクトまで、最適なご提案を心を込めてさせていただきます。
ぜひ、プロフィールやWeb制作会社様向け業務案内、一般企業様向け業務案内もご覧くださいね。
Gitでコードの変更履歴を調べる:git blame・git show・git logの使い分け
2026.11.01
このコードはいつ、誰が、どのコミットで変更したのか。git blame・git show・git logを使い、特定行の最終変更や、削除された条件の履歴を調べる方法を紹介します。GitHub・Bitbucket Cloudでの確認方法と、Pull Requestや関連課題から変更理由を調べる流れも説明します。