# 第一次合进主干全是配置冲突

**URL:** <https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E5%90%88%E8%BF%9B%E4%B8%BB%E5%B9%B2%E5%85%A8%E6%98%AF%E9%85%8D%E7%BD%AE%E5%86%B2%E7%AA%81/34>\
**Category:** 筑码工坊\
**Tags:** 构建实操\
**Created:** [2026 年10 月 3 日 15:12 UTC](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E5%90%88%E8%BF%9B%E4%B8%BB%E5%B9%B2%E5%85%A8%E6%98%AF%E9%85%8D%E7%BD%AE%E5%86%B2%E7%AA%81/34 "2026-10-03T15:12:00Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![hetaoyu](https://buildx.do/letter_avatar_proxy/v4/letter/h/b38774/32.png) [@hetaoyu](https://buildx.do/u/hetaoyu)\
**Post date:** [2026 年10 月 3 日 15:12 UTC](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E5%90%88%E8%BF%9B%E4%B8%BB%E5%B9%B2%E5%85%A8%E6%98%AF%E9%85%8D%E7%BD%AE%E5%86%B2%E7%AA%81/34/1 "2026-10-03T15:12:00Z")

</div>

业务代码几乎没有冲突，冲突全在配置：本机数据库地址、端口、一个只在我电脑上存在的路径。

这些值不该进主干。我们留了一份示例配置，真实配置写进忽略列表。每个人从示例复制一份再填。

已经进过主干的真实地址，从最新文件里拿掉，并在说明里写上‘不要再提交’。历史里的旧值如果还敏感，就按密钥那套作废，而不是假装没发生。

合入前看差异时，配置文件单独看一遍。业务代码的冲突可以慢慢对，配置冲突往往是有人把本地值交上来了。

示例文件里的值用明显的假地址，避免有人复制之后没改就连上某台真机器。

下一次合主干，配置没有再冲突。冲突回到了真正的代码分歧上。

本地能跑和别人能跑是两件事。我现在固定留三样：启动时实际读到的配置名、当前连的库名、监听的端口。这三样打在日志开头，不打密钥和连接串。提交前看差异，示例配置和真实配置分开，锁文件跟清单一起走。干净目录克隆后再装一次，比在自己机器上反复点运行更可信。

这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。

复查「第一次合进主干全是配置冲突」时按这四步，不靠感觉。用改之前的同一组输入再走一遍，结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名，确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。

补充记录。本地构建我现在把它当成一份可以交接的步骤，而不是个人习惯。第一步，在干净目录克隆，不在自己改了一半的目录里证明‘能跑’。第二步，只看三行启动日志：配置名、库名、端口。对不上就停，不继续点页面。第三步，依赖以锁文件为准。清单写着能装，锁文件才决定装到哪一版。第四步，提交前看差异，配置里的地址、密钥、本机路径不要出现。示例文件用明显的假值。第五步，让另一个人按说明走一遍，走不通就改说明，不改口头解释。这五步做完，构建才算从‘我的机器’变成‘这个仓库’。漏掉干净目录或锁文件，问题会在别人那里才出现，而且看起来像环境玄学。

操作顺序。1. 在临时目录克隆一份干净代码，不在日常目录里验证。2. 按说明安装，锁文件和清单必须同时存在。3. 启动后只看三行日志：配置名、库名、端口。任一为空或对不上，就停。4. 用一条最小请求打通，再跑测试。5. 提交前看差异，确认没有地址、密钥、本机路径。6. 换一个同事的机器或一个新目录再走一遍。走不通就改说明，不增加口头步骤。做完把失败过的那一次也留下，只留成功，别人会在同一个地方再摔一次。

---

<div class="post-metadata">

**Author:** ![caiwen](https://buildx.do/letter_avatar_proxy/v4/letter/c/bc79bd/32.png) [@caiwen](https://buildx.do/u/caiwen)\
**Post date:** [2026 年10 月 3 日 16:26 UTC](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E5%90%88%E8%BF%9B%E4%B8%BB%E5%B9%B2%E5%85%A8%E6%98%AF%E9%85%8D%E7%BD%AE%E5%86%B2%E7%AA%81/34/2 "2026-10-03T16:26:00Z")

</div>

地址、密码、本机路径不要进主干。留一份示例配置，各自复制后再填。
