【Git】pullで「untracked working tree files would be overwritten by merge」の解決方法完全ガイド

git pullを実行したら、こんなエラーメッセージが表示されて止まってしまった…

$ git pull
error: The following untracked working tree files would be overwritten by merge:
        config.ini
        data/settings.json
Please move or remove them before you merge.
Aborting

この記事では、エラーの原因から状況別の解決方法まで5つのパターンを解説します。

エラーの原因

このエラーは次の状況で発生します。

• リモートリポジトリには存在するファイルが、ローカルでは git add も git commit もされていない状態で存在している
• git pullによるマージがそのファイルを変更・作成しようとしている

要するに「リモートが更新しようとするファイルと同名のファイルがローカルに野良で存在している」状態です。

現在の状態を確認する

まず git status でどのファイルが問題なのかを把握します。

$ git status
On branch main
Your branch is behind 'origin/main' by 2 commits, and can be fast-forwarded.
  (use "git pull" to update your local branch)

Untracked files:
  (use "git add ..." to include in what will be committed)
        config.ini
        data/settings.json

nothing added to commit but untracked files present

「Untracked files」として表示されているファイルが原因です。

解決方法1: ファイルを削除する（変更が不要な場合）

エラーに表示されているファイルが不要であれば、削除してから再度 git pull を実行します。

# ファイルを削除
$ rm config.ini
$ rm data/settings.json

# 再度pull
$ git pull

Windowsの場合は del コマンドを使います。

del config.ini
del data\settings.json

解決方法2: git stashで一時保存する（変更を残したい場合）

ファイルに手を加えていて変更を残したい場合は、git stashで一時退避させます。ただし、untrackedファイルは通常のstashでは保存されないため -u オプションが必要です。

# untrackedファイルも含めてstash
$ git stash -u
Saved working directory and index state WIP on main: abc1234 前回のコミット

# pullを実行
$ git pull

# stashを戻す（競合する場合は手動マージ）
$ git stash pop

解決方法3: ファイルをバックアップして移動する

削除は怖いが変更もない、というケースでは別の場所に移動するのが安全です。

# Linuxの場合
mv config.ini config.ini.bak
mv data/settings.json data/settings.json.bak

# Windows（コマンドプロンプト）
ren config.ini config.ini.bak
ren data\settings.json settings.json.bak

# その後pull
$ git pull

pullが成功したら、バックアップと新しいファイルを比較して必要な変更をマージできます。

解決方法4: .gitignoreに追加する

そのファイルを今後もGit管理外にしたい場合は .gitignore に追加します。ただし、これだけではpullのエラーは解決しません。先にファイルを削除または移動してからpullし、その後.gitignoreに追加する流れになります。

# まずファイルを削除
$ rm config.ini

# pullを実行
$ git pull

# .gitignoreに追加
$ echo "config.ini" >> .gitignore
$ git add .gitignore
$ git commit -m "Add config.ini to .gitignore"

解決方法5: git checkout –force（強制チェックアウト）

untracked filesを含むすべてのローカル変更を捨ててリモートと完全に一致させたい場合に使います。

# リモートの最新を取得
$ git fetch origin

# 強制的にリモートの状態に合わせる
$ git checkout --force origin/main

複数ファイルが一括で対象になる場合

エラーに大量のファイルが列挙される場合、以下のコマンドで一括削除できます。

# Gitが追跡していないファイル・フォルダを一括削除（確認付き）
$ git clean -nd   # まず削除対象を確認（ドライラン）
$ git clean -fd   # 実際に削除（ファイルとディレクトリ）

解決方法の選び方まとめ

よくある質問（FAQ）

関連記事

• 【Git】コンフリクトしてpullできないときの対処法完全ガイド
• 【Git】pull時のエラー「Pulling is not possible because you have unmerged files」の解決方法
• 【Git】untracked filesの解消方法
• 【Git】「you need to resolve your current index first」の解決方法完全ガイド

まとめ