合并后编译失败往往因冲突未真正解决：表面删除冲突标记不等于逻辑完整，需确认git status干净、git diff --staged无残留标记，并检查头文件、配置文件、构建脚本及类型接口变更，同时排除环境差异与测试覆盖盲区。
合并后编译失败，先确认是不是冲突没真正解决
很多人以为删掉 和 <code>>>>>>> main 这些标记就等于解决了冲突，但实际只是“表面清理”。编译失败往往是因为：保留的代码逻辑不完整、函数签名被改但调用处没同步、条件分支里漏删了半截代码、或者误删了关键 import/using 声明。
检查方法很简单：git status 必须显示 “nothing to commit, working tree clean”，且没有 unmerged paths；再运行 git diff --staged，确认暂存区里没有残留的冲突标记（哪怕只有一行）。
- 用
grep -n ">>>>>>" *扫一遍所有改动文件（尤其 .cpp/.java/.ts/.py），别信编辑器自动高亮——有些标记可能藏在注释块或字符串里 - 重点关注被修改过的头文件、配置文件、构建脚本（如
CMakeLists.txt、package.json、build.gradle），这些地方冲突容易被忽略但直接影响编译 - 如果用了 TypeScript 或 Rust 等强类型语言，打开 IDE 的实时类型检查，比单纯跑
make或npm build更早暴露问题
合并引入了不兼容的 API 变更
两个分支各自升级了依赖或重构了模块，合并后出现 “undefined reference”、“cannot find module”、“no matching function for call” 这类错误，不是语法问题，而是语义断层。Git 不会告诉你 HttpClient.send() 已被重命名为 HttpClient.request()，也不会提醒你 config.yaml 里 timeout_ms 字段已移入 network 子节。
这类问题必须靠人工交叉核对变更范围：
- 用
git log --oneline HEAD^..HEAD查看刚合并进来的提交列表，重点扫一眼 commit message 里带 “refactor”、“upgrade”、“breaking” 的条目 - 对关键模块，执行
git diff origin/main...HEAD -- src/utils/network.ts（把路径换成你实际的文件），对比前后接口定义 - 如果团队有 CHANGELOG.md，合并前应主动查它；没有的话，至少翻一翻被改动文件的最近三次
git blame，看谁 last touched 这块，直接问
编译环境或工具链版本不一致
本地能编译通过，CI 报错；或者 A 同学机器上 OK，B 同学报 “error: ‘std::filesystem’ is not a member of ‘std’”，大概率是环境差异。合并本身没毛病，但不同人用的编译器、SDK、Node.js 版本不同，导致同一份代码行为不一致。
OpenClaw 技能 — 给定一个 GitHub 仓库 URL，自动解析出 owner/repo 名称，发现其中的 YAML/properties 配置文件及其配对的中文字段说明；在 `workspace/{repo}/` 目录下按同步日期（格式为 `YYYY-MM-DD`）创建时间戳子目录；写入 `.openclaw-config-state.json` 状态文件。每次用户提问前，先比对远程仓库当前 ref（如 `main` 或 `master`）的最新提交 SHA 与本地状态文件中记录的 SHA：
这不是 Git 的锅，但必须在合并流程里堵住：
- 检查项目根目录有没有
.node-version、.tool-versions、compiler_version这类约束文件，没有就补上；有的话确认它被git add进去了 - CI 配置里明确指定工具版本，比如 GitHub Actions 中写死
uses: actions/setup-node@v4+with: { node-version: '20.18.0' }，而不是node-version: '20.x' - 本地开发时，用
make check-env或类似脚本统一校验（比如检查gcc --version输出是否匹配required_gcc_version文件里的值）
合并后测试未覆盖的隐性破坏
编译通过 ≠ 功能正常。常见情况：合并删掉了某个兜底逻辑，但单元测试没覆盖那个边界条件；或者两个分支各加了一个互斥的 feature flag，合并后 flag 判断链断裂；又或者数据库 migration 脚本被覆盖，导致本地 make db-migrate 卡在中间步骤。
这类问题不会报错，但上线后出事。预防比补救重要：
- 合并前，在本地跑全量测试：不是只跑
npm test，而是npm run test:ci（模拟 CI 环境）、npm run lint、npm run type-check一起走 - 如果项目有集成测试或 e2e 测试，强制要求 PR 描述里写明 “已验证 XXX 流程”，并截图或录屏留痕——别只说“过了”
- 对数据库相关变更，合并后第一件事不是推远端，而是
git checkout main && git merge your-branch && make db-reset && make db-migrate，确保迁移脚本能串起来
编译失败背后，八成不是 Git 操作错了，而是人没看清自己和别人改了什么。越想快点 git push，越要花时间看 git diff、读别人的 commit、跑一遍真实构建流程。工具不会替你理解代码意图。
