【Git】untracked filesの解消方法｜add・.gitignore・git clean・stashの使い分け完全ガイド

$ git status
On branch main
Untracked files:
  (use "git add <file>..." to include in what will be committed)
	debug.log
	tmp/
	.vscode/
	node_modules/

nothing added to commit but untracked files present (use "git add" to track)

# 既定：ディレクトリ配下をまとめて表示
git status
# → "node_modules/" のようにディレクトリで1行

# -u all：配下のすべてのファイルを展開表示
git status -u
git status --untracked-files=all

# -u no：untracked非表示（集中したいとき）
git status -uno

# コンパクト表示（2文字ステータス）
git status -sb
# 出力例: ?? debug.log  ← ??がuntracked

# 既定のuntracked表示モードをno に変更
git config --global status.showUntrackedFiles no

# 単一ファイル
git add src/new_feature.py

# 複数ファイル
git add src/auth.py src/utils.py

# ディレクトリ配下すべて
git add src/

# カレントディレクトリ以下すべて（.gitignore対象以外）
git add .

# インタラクティブに選ぶ
git add -i

# 状態確認
git status

# コミット
git commit -m "feat: 新機能ファイルを追加"

# ログファイル
*.log

# ビルド成果物
dist/
build/
*.min.js
*.min.css

# 依存パッケージ
node_modules/
vendor/
__pycache__/

# 環境変数
.env
.env.local

# IDE
.vscode/
.idea/

# OS
.DS_Store
Thumbs.db

# すべてのログ除外、でもimportant.logだけは追跡
*.log
!important.log

# ルートのdistだけ無視、サブのsrc/distは追跡
/dist/

# すべての.cacheを再帰的に無視
**/.cache/
**/node_modules/

# 特定ファイル名のみ除外
config.local.json

# グローバル.gitignoreの場所を設定
git config --global core.excludesfile ~/.gitignore_global

# ファイルに記述（環境固有）
cat >> ~/.gitignore_global << "EOF"
# macOS
.DS_Store
# Windows
Thumbs.db
Desktop.ini
# Linux
*~
# エディタ
*.swp
.idea/
.vscode/
EOF

# dry-run：何が削除されるかだけ表示（必須）
git clean -n
git clean --dry-run

# 対話モード：1つずつ確認しながら削除
git clean -i
git clean --interactive

# 確認なしで強制削除（ファイルのみ）
git clean -f
git clean --force

# ディレクトリも含める
git clean -fd

# .gitignore対象ファイルも含めて削除（最強）
git clean -fdx

# 特定パスだけ
git clean -fd src/tmp/

# untrackedも含めてstash
git stash push --include-untracked -m "untracked退避"
git stash push -u -m "untracked退避"

# ignoredまで含めたい場合（レアケース）
git stash push --all -m "全部退避"

# 特定ファイルだけ
git stash push -u -m "debug退避" -- debug.log tmp/

# 確認
git stash list

# 戻す
git stash pop

# stashの中身を見る
git stash show -p stash@{0}

# untracked一覧だけ抽出（スクリプト用途に便利）
git ls-files --others --exclude-standard

# ignoredも含めて確認
git status --ignored

# 特定パターンだけdry-run確認してから削除
git clean -n -- "*.log"
git clean -f -- "*.log"

# ディレクトリ配下だけ
git clean -nd src/tmp/
git clean -fd src/tmp/

# 大量のuntrackedをまずは把握
git ls-files --others --exclude-standard | wc -l
# → 47 など

# なぜこのファイルが無視されない／されているかを確認
git check-ignore -v debug.log
# 出力例: .gitignore:5:*.log   debug.log  ← .gitignoreの5行目のルールでマッチ
# 何も出なければ無視対象ではない

# .gitignoreのどの行が効いているか詳細表示
git check-ignore -v --no-index tmp/foo.txt

# ファイルが誰に／いつ作られたか調査
stat debug.log
lsof debug.log   # 開いているプロセス

# 全設定を含めた ignore 判定
git check-ignore --verbose --all debug.log

# 現状確認
git status
git ls-files --others --exclude-standard | head -50

# .gitignore を整備
cat > .gitignore << "EOF"
node_modules/
dist/
build/
.env
*.log
.DS_Store
.vscode/
.idea/
EOF

# 残ったuntrackedを追加
git add -A
git commit -m "feat: initial commit"

# .gitignoreに追加
echo "node_modules/" >> .gitignore

# 既に追跡されている分を index から外す
git rm -r --cached node_modules/

# commit
git add .gitignore
git commit -m "chore: node_modulesを追跡対象から除外"

# 事前確認（必ず）
git clean -nx
git clean -nxd

# ビルド成果物とパッケージ丸ごと削除
git clean -fdx

# 再構築
npm install
npm run build

# 未追跡含めてstash
git stash push -u -m "wip: feature試作中"

# 別ブランチへ移動
git switch main

# 作業終わったら戻る
git switch feature/xxx
git stash pop