Unity 场景在 Git 里合并不了，该怎么修？

Game Developer 指南走了一遍每个 Unity 开发者都认得的场景：你合并一个功能分支，Git 先打印正在自动合并某个场景文件，接着报冲突、自动合并失败，让你修好冲突再提交。指南例子里的文件叫 GameOver.unity，但名字不重要；重要的是失败的形态：两个分支改了同一个场景，而擅长合并代码的 Git 突然力不从心了。指南接着运行 git mergetool，接手的是 Unity 自带的 Smart Merge，也就是 UnityYAMLMerge。Git 放弃、Smart Merge 接手，这个两步形态就是本文的全部故事。

根因在冲突提示的下一层。Unity 场景文件是一份 YAML 文档，列出每个 GameObject、每个组件、以及它们之间的每个引用。两个人改同一个场景里的不同对象时，Git 看到的仍是一份在重叠或相邻行里有改动的文件，于是哪怕没人改过同一个对象，它也会报冲突。更糟的是，纯文本合并根本不知道场景是什么：它能把 YAML 块拼成看起来合好了的样子，却破坏对象引用，因为它从不检查结果是不是合法场景。而如果项目从没设为 Force Text，情况还要糟：Game Developer 指南说得很直白，二进制文件的改动永远无法自动合并、一定会冲突。所以修复要从合并之前开始，从项目设置开始，而不是在冲突界面上临时想办法。

Unity 6000.6 文档把 UnityYAMLMerge 描述为以语义正确的方式合并场景、prefab 与 meta 文件的工具。“语义正确”是关键词：Git 看到的是行，这个工具看到的是对象，所以同一个场景里不同对象的改动可以合并而不是冲突。文档对它的上限也说得很清楚：它不处理的文件、以及它解决不了的冲突，会交给 mergespecfile.txt 里列出的兜底合并工具；用 premerge 选项时，它先合并所有能合并的部分，再把只剩冲突的文件交给兜底工具。默认它不合并 material、asset、controller 这类其他 YAML 文件，那些会走兜底工具，除非你用 force 选项强制。所以 Smart Merge 不是终结合并冲突的魔法，它是一个理解场景结构的工具，解决容易的大多数，剩下的交给人工。

配置分两半，文档里都有。第一，项目本身：在 Edit、Project Settings、Editor 里，把 Version Control 模式设为 Visible Meta Files，让 meta 文件以普通文件形式写入；把 Asset Serialization 模式设为 Force Text，让场景和 prefab 以 YAML 文本存储。Unity 6000.3 编辑器设置参考说 Force Text 是默认值，还提供一个减少版本控制噪音的选项，把 YAML 引用写在一行——这个选项的存在正是因为场景保存时可能改写比你动过的更多的行。Game Developer 指南补了团队层面的理由：这些设置存在 ProjectSettings 里、跟着仓库走，所以队友会直接继承。第二，Git 一侧：在仓库配置或全局 gitconfig 里把 UnityYAMLMerge 加为合并工具，trustExitCode 设为 false，合并命令传入 base、remote、local 与 merged 四个文件。核对文档时发现一个警告：Game Developer 指南里的旧工具路径（Contents Tools 文件夹下）已经过时。Unity 6000.6 文档说，工具在 Unity Hub 编辑器安装目录下，Windows 与 Linux 在 Editor Data Tools 里，macOS 在 Unity 应用的 Helpers 文件夹里。请从你自己装的编辑器版本里复制路径，不要抄旧博客。

下面所有步骤只适用于你自己的项目和你自己的仓库，不碰线上服务、共享服务器或别人的工作。最重要的一步也是最不起眼的一步：合并后、提交前，先在 Unity 里打开场景。Game Developer 指南警告，Git 有时会在冲突实际已解决时仍报告文件未变，它给的检验方法正是这一条：在 Unity 里打开冲突文件，如果里面还残留冲突标记，它会打不开；如果能打开，就在 Inspector 里检查两侧的新值都在。合并好的场景不是 Git 说了算，而是编辑器能打开、两侧改动都看得见才算。