孤独求学人

The following untracked working tree files would be overwritten by checkout

2024-12-26 杜世伟

当执行 git checkout 或类似命令时，出现 "The following untracked working tree files would be overwritten by checkout" 的错误，说明当前目录中的某些未被 Git 跟踪的文件，与目标分支中存在同名文件，且 Git 阻止这些文件被覆盖。

产生原因

未跟踪文件（Untracked Files）冲突：

当前工作目录中有未被 Git 跟踪的文件，这些文件的路径与目标分支中的文件相同。 如果切换分支，将导致未跟踪文件被覆盖或丢失。

分支之间文件结构不同：

目标分支中可能新增了某些文件，这些文件与当前目录中的未跟踪文件重名。 误操作导致的未跟踪文件残留：

例如，手动复制文件到工作目录中，或者从其他工具中生成的临时文件。

解决方案

1. 查看冲突的未跟踪文件 首先，检查有哪些未跟踪的文件导致冲突：

   git status 或者直接列出冲突文件： git checkout target-branch Git 会明确提示哪些文件冲突。

2. 删除未跟踪的文件 如果这些未跟踪的文件不重要，可以直接删除：

   rm file.txt 如果有多个未跟踪文件，可以批量清理：

   git clean -f 清理未跟踪的目录（如果存在）： git clean -fd

3. 备份未跟踪文件 如果需要保留这些未跟踪的文件，建议先备份它们： mkdir backup cp file.txt backup/ 也可以直接备份整个工作目录： tar -czvf backup.tar.gz .

4. 将文件临时存储到 Git 如果你希望保留未跟踪文件，并暂时保存当前状态，可以使用 git stash： git add file.txt git stash git checkout target-branch 稍后可以通过 git stash pop 恢复这些更改。

5. 强制切换分支 如果明确知道这些未跟踪文件可以被覆盖，可以使用强制切换： git checkout -f target-branch 注意：此操作会直接覆盖未跟踪文件，请谨慎使用！

总结 这类错误是 Git 的保护机制，防止未跟踪文件被意外覆盖。你可以通过清理、备份或强制覆盖的方式来解决问题。为了避免这种情况，建议在操作前保持工作区干净，确保没有未跟踪的文件干扰操作。

标签: git checkout