如何在Git仓库中将含冲突标记的文件强制标记为未合并状态？

当Git合并分支产生冲突时，会提示文件处于未合并状态，示例如下：

% git status
On branch test-merge
You have unmerged paths.
  (fix conflicts and run "git commit")
  (use "git merge --abort" to abort the merge)

Changes to be committed:
        modified:   .gitignore
        new file:   build.py

Unmerged paths:
  (use "git add <file>..." to mark resolution)
        both modified:   Makefile
        both modified:   duties.py
        both modified:   pyproject.toml

现在在一个未处于合并状态的干净Git仓库中，手动给某些文件添加了冲突标记，示例如下：

<<<<<<< before updating
=======
This line was added
>>>>>>> after updating

如何让Git将这类带有冲突标记的文件报告为「未合并」状态，即便实际并未处于Git合并流程中？

背景：Copier是一款项目模板工具，核心功能之一是项目模板更新——基于Copier模板生成项目、迭代项目，当模板迭代后，可将模板变更应用到项目中并保留项目自有变更。Copier执行更新后，有时会在文件中遗留冲突标记，但这些标记并非来自Git合并，导致VSCode等工具无法提供与Git未合并文件相同的用户体验：

• 源代码控制标签会跳转到普通差异视图，而非带有「接受传入」「接受当前」「接受两者」等按钮的合并冲突视图
• 含冲突标记的文件不会被归类到「合并变更」区域，而是全部放在基础「变更」区域
• 不会阻止暂存含冲突标记的文件，因为Git未将其识别为未合并状态

另外注意到Git合并过程中，.git文件夹会生成AUTO_MERGE、MERGE_HEAD、MERGE_MODE、MERGE_MSG等文件，是否可以通过手动创建这些文件（比如在MERGE_HEAD中使用任意伪造的Git引用），强制Git将含冲突标记的文件报告为未合并状态？同时也好奇是否方向有误，是否应该向VSCode提交功能请求，使其无论Git报告如何都能识别带有冲突标记的文件。

一、手动模拟Git合并状态的可行方法 #

Git识别「未合并状态」不仅依赖.git下的合并相关文件，还需要文件在Git索引中处于未合并的暂存状态（即索引中存在该文件的三个版本：:1:file共同祖先、:2:file当前分支、:3:file合并分支）。仅创建MERGE_HEAD等文件不足以生效，需要结合以下步骤：

1. 创建合并标记文件
   在.git目录下手动创建必要文件：

• 创建MERGE_HEAD：写入任意有效的Git引用（比如当前分支的提交哈希，或随便生成的40位十六进制字符串）
• 创建MERGE_MODE：写入merge（表示普通合并模式）
• 可选创建MERGE_MSG：写入合并提交提示信息，比如Merge template updates from Copier

2. 将文件标记为未合并状态
   以目标文件example.py为例：

• 先备份当前内容：cp example.py temp_example.py
• 清空文件的暂存状态：git rm --cached example.py
• 模拟索引中的三个版本（用文件的HEAD版本作为共同祖先，备份文件作为合并分支版本，当前文件作为当前分支版本）：

  git update-index --cacheinfo 100644 $(git rev-parse HEAD:example.py) example.py
  git update-index --cacheinfo 100644 $(git hash-object temp_example.py) example.py
  git update-index --cacheinfo 100644 $(git hash-object example.py) example.py
  

• 将备份内容写回原文件（保留冲突标记）：cp temp_example.py example.py

执行git status后，该文件会被标记为both modified的未合并状态，VSCode也会识别为合并冲突文件。

3. 清理模拟状态
   冲突解决后，需要清理模拟状态：

• 执行git add example.py标记冲突已解决
• 删除.git下的MERGE_HEAD、MERGE_MODE、MERGE_MSG文件
• 提交变更：git commit（会自动使用MERGE_MSG中的信息，或自定义提交内容）

二、更简洁的替代方案 #

手动模拟步骤繁琐易出错，更推荐以下两种方式：

1. 使用Git的git merge-file命令
   用git merge-file工具将带冲突标记的文件转换为Git认可的未合并状态：

# 备份当前文件内容
cp example.py example.py.conflict
# 获取文件的HEAD版本作为共同祖先
git show HEAD:example.py > example.py.base
# 执行合并，将当前内容作为本地版本，备份内容作为远程版本
git merge-file -p example.py example.py.base example.py.conflict > example.py

执行后，Git会将该文件标记为未合并状态，同时保留冲突标记。

2. 向VSCode提交功能请求
   核心问题是VSCode未识别非Git产生的冲突标记，直接向VSCode提交功能请求，使其支持识别文件中的<<<<<<</=======/>>>>>>>冲突标记并提供对应合并冲突处理UI，是更长期的解决方案。

内容的提问来源于stack exchange，提问作者pawamoy