サーバー上でGitを使用して作業していると、次のようなエラーメッセージが表示されることがあります。

error: The following untracked working tree files would be overwritten by merge:
    jobs/code_project/config.xml
    jobs/code_project_pipeline/config.xml
    jobs/deploy_api/config.xml
Please move or remove them before you merge.

この記事では、このエラーの原因と対処方法について解説します。

💡 原因

このエラーは、マージしようとしているブランチに存在するファイルが、現在の作業ディレクトリにある「Git未管理のファイル」と衝突してしまう場合に発生します。

Gitは未管理（untracked）のファイルを勝手に上書きすることを避けるため、マージを拒否します。

✅ 解決方法

以下の手順で、安全にマージを完了させることができます。

1. 📁 対象ファイルを確認

まず、衝突しているファイルが本当に必要なものか確認します。

ls -l jobs/codebuild_other_project/config.xml

2. 🗂️ ファイルを一時退避（バックアップ）

対象ファイルを退避ディレクトリへ移動します。

mkdir -p ~/backup_config_files
mv jobs/code_project/config.xml ~/backup_config_files/
mv jobs/code_project_pipeline/config.xml ~/backup_config_files/
mv jobs/deploy_api/config.xml ~/backup_config_files/

3. 🔄 再度マージを実行

退避が完了したら、マージ操作を再実行します。

git merge <branch-name>

4. 🔍 マージ後のファイルと比較して差分確認

退避したファイルとマージ後のファイルを比較して、必要に応じて統合します。

diff ~/backup_config_files/config.xml jobs/code_project/config.xml

❌ ファイルが不要な場合

もし、対象ファイルが不要であれば削除して問題ありません。

rm jobs/code_project/config.xml
rm jobs/code_project_pipeline/config.xml
rm jobs/deploy_api/config.xml

その後、マージを実行してください。

📌 今後同じことを防ぐには？

頻繁に同じパターンのファイルが出現する場合、.gitignore に対象パスを追加することで、Gitの管理対象外として扱うことができます。

jobs/*/config.xml

🔚 まとめ

手順	内容
1.	エラーの対象ファイルを確認
2.	ファイルを退避または削除
3.	再度マージを実行
4.	差分を確認して必要ならマージ後に調整
5.	`.gitignore` の検討も忘れずに

Git操作では「untracked」ファイルが意外な落とし穴になることがあります。焦らずに、ファイルの重要性を確認してから、適切な対処をしましょう！