【Git】.gitignoreが効かない原因と解決方法｜6パターン診断・check-ignore徹底活用ガイド

# 1. 変更ファイルをスキャン
# 2. .gitignore に該当するか判定
#    - tracked（index にある）→ ignore しない（変更として表示）
#    - untracked → ignore する（表示しない）

# 確認コマンド
git ls-files | grep config.local.json   # tracked なら出力あり
git check-ignore -v config.local.json   # どのルールでマッチするか

# このファイルがignoreされるか確認
git check-ignore -v config.local.json
# 出力例: .gitignore:5:*.json    config.local.json
# → .gitignoreの5行目のパターン "*.json" にマッチ

# 何も出ない → ignore対象ではない（パターンが効いていない）

# tracked かどうか確認
git ls-files --error-unmatch config.local.json 2>/dev/null && echo "tracked" || echo "untracked"

# 全ての適用ルールを確認（複数あれば）
git check-ignore -v --all config.local.json

# untracked+ignored も含めた全体像
git status --ignored

# どのファイルがignoreされているかプロジェクト全体で
git ls-files --others --ignored --exclude-standard

# .gitignoreに対象を追加（未追加なら）
echo "config/secrets.env" >> .gitignore

# indexから外す（ファイルは作業ツリーに残る）
git rm --cached config/secrets.env

# ディレクトリなら -r
git rm -r --cached node_modules/

# globで一括
git rm --cached "*.log"

# 追跡解除＋.gitignoreを1コミットにまとめる
git add .gitignore
git commit -m "chore: 機密ファイル・ビルド成果物を追跡対象から除外"

# push
git push

# 誤: コメントや末尾空白で判定ズレ
*.log              # ← 末尾空白があるとマッチしない

# 正: 余計な空白なしで書く
*.log

# 誤: 絶対パス風の指定（sub/以下のmatchは期待通りでないことも）
/build             # ルート直下のbuildのみ

# 正: 全階層のbuildを除外したいなら
**/build/
# または
build/

# 誤: ファイルと誤解される
dist               # ファイル名 dist か dir dist かあいまい

# 正: ディレクトリは末尾 / を付ける
dist/

# 誤: 再帰表記が効かない環境
**/node_modules    # 末尾 / なし

# 正: 明確に
**/node_modules/

# 誤: 順序が逆で!が効かない
!important.log
*.log
# → *.log が後勝ち。important.log も無視される

# 正: 除外ルールの後に例外を書く
*.log
!important.log
# → important.log だけ追跡

# ディレクトリ配下をignoreしつつ特定ファイルだけ追跡
logs/
!logs/.gitkeep     # ← これは効かない場合がある（後述）

# 誤: logs/ 全体を除外したあとは !logs/keep.txt が効かない
logs/
!logs/keep.txt

# 正: 親を「中身だけ無視」扱いに変える
logs/*
!logs/.gitkeep
!logs/README.md
# → logs/ ディレクトリ内のファイルは無視、指定ファイルだけ追跡

# サブディレクトリも再帰的に制御したいなら
logs/**/*
!logs/**/.gitkeep

# どのルールが勝っているか
git check-ignore -v --all config.local.json
# → 複数のルールがあれば全て表示

# 各ルール設定の在り処
find . -name ".gitignore"
cat .git/info/exclude
git config --get core.excludesfile
cat "$(git config --get core.excludesfile)"

# BOMの有無を確認（BOMがあると3バイトEF BB BFが先頭に）
xxd .gitignore | head -1

# 改行コードを確認（LF=$, CRLF=^M$）
cat -A .gitignore | head -5

# CRLF→LFに変換
dos2unix .gitignore
# または
sed -i 's/\r$//' .gitignore

# BOMを除去
sed -i '1s/^\xEF\xBB\xBF//' .gitignore

# 末尾空白を除去
sed -i 's/[[:space:]]*$//' .gitignore

# 現在のindexを全部消す（作業ツリーは残る）
git rm -r --cached .

# 再度add（新しい.gitignoreに従って追加される）
git add .

# 変更内容を確認
git status
# → 該当ファイルがdeletedとして表示される（.gitignoreに該当したもの）

# コミット
git commit -m "chore: .gitignoreを適用してindexを再構築"

# GitHubの公式テンプレート集
# https://github.com/github/gitignore

# gibo（git ignore boilerplate）ツール
brew install gibo
gibo dump Node macOS VisualStudioCode > .gitignore

# コマンドラインでテンプレート取得
curl -sL https://www.toptal.com/developers/gitignore/api/node,macos > .gitignore

# 新規プロジェクト時の推奨フロー
git init
gibo dump Node > .gitignore
# 必要なパターンを追加
git add .gitignore
git commit -m "chore: initialize .gitignore"

# 状況: .env をうっかりcommitしてしまった
echo ".env" >> .gitignore
git rm --cached .env
git add .gitignore
git commit -m "chore: .envを追跡対象から除外"

# 重要: pushされていた場合は機密情報rotateも忘れずに

echo "node_modules/" >> .gitignore
git rm -r --cached node_modules/
git add .gitignore
git commit -m "chore: node_modulesを追跡対象から除外"
git push

# チームに通知：pull後、再インストール必要
# 他メンバーが実行: npm install

# .gitignore
logs/*
!logs/.gitkeep

# 確認
git check-ignore -v logs/debug.log
# → .gitignore:X:logs/* logs/debug.log

git check-ignore -v logs/.gitkeep
# → 何も出ない（追跡対象）

# どのルールが効いているか確認
git check-ignore -v config.local.json

# ケースA: 何も出ない → パターン文法修正
# ケースB: 出力あり＋tracked → rm --cached
# ケースC: 意図しないルール → 優先順位調整

# 行数を覚えておくと便利
grep -n "config.local" .gitignore