如何通过.gitattributes禁止Git与Visual Studio自动合并特定文件

你的配置没生效是两个问题叠加导致的：

• 规则匹配不严谨：当前写的version merge=binary会递归匹配仓库所有子目录下叫version的文件，没有锚定根目录路径的情况下，VS内置的封装Git客户端经常会漏命中这类无后缀文件的属性规则。
• VS的内置逻辑绕过了原生Git规则：「Commit All and Sync」调用的是微软定制的Git实现，旧版本不会读取.gitattributes里的merge driver配置，对单行纯文本文件会默认静默走自动合并，根本不会触发binary驱动的冲突标记。另外merge=binary仅在默认三向合并场景生效，如果你本地Git开了pull.rebase=true，这个规则本来也不会触发冲突。

按以下步骤配置即可实现version文件永远不被自动合并，必须手动处理：

1. 替换.gitattributes规则，自定义强制冲突的合并驱动 #

把配置里原来的version merge=binary替换为下面的内容，锚定根目录的version文件：

/version  merge=always-conflict

所有使用该仓库的开发人员，本地执行两条全局Git命令，注册这个自定义合并驱动：

git config --global merge.always-conflict.name "Force conflict for tracked file"
git config --global merge.always-conflict.driver "false"

原理：Git调用合并驱动时只要收到非0返回值就会直接标记文件为冲突，不会做任何自动合并尝试，false命令固定返回退出码1，属于原生Git层面的硬规则，不受文件是文本还是二进制的影响，兼容性比内置binary驱动好很多。

2. 修正Visual Studio的Git配置，关闭静默自动合并 #

• 打开VS的Git全局设置，找到拉取时的变基选项，设置为拉取时使用合并而非变基，避免rebase流程跳过merge driver的触发逻辑。
• 找到「自动解决非冲突更改」的开关，取消勾选，禁止VS在合并时静默处理文件分歧，只要有文件存在版本差异就弹出冲突处理面板。
• 如果你用的是VS2022及以上版本，直接把Git后端切换为系统安装的原生Git：在Git设置的「Git可执行文件路径」选项里，选择你本地独立安装的Git路径（默认是C:\Program Files\Git\bin\git.exe），原生Git会完全遵守.gitattributes的所有规则，不会出现内置客户端的规则漏读问题。

3. 配套流程优化（可选） #

可以在仓库贡献说明里明确：本地开发不需要手动修改version文件，该文件的变更完全由CI流水线自动维护，拉取遇到该文件冲突时，直接执行git checkout --theirs version && git add version即可快速解决，不需要手动对比版本内容，从流程上避免误覆盖远程版本的问题。

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