技術資料

.gitignoreに書いたのに除外されないときの調べ方:追跡済みファイルと除外ルールを確認する

作成日:2026.11.20

Git

.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や関連課題から変更理由を調べる流れも説明します。

Bitbucket Git GitHub

阿部辰也へのお仕事の依頼・お問い合わせ

軽いご相談もお気軽にどうぞ!

個人情報の取り扱いについて *必須 プライバシーポリシーをご確認いただき、同意いただける場合は「同意する」にチェックをしてください。

keyboard_double_arrow_up
TOP