如何在GitHub上实现特定JSON文件变更时强制用户手动合并？

核心需求回顾 #

你需要：

• 特定JSON文件在GitHub端禁止自动合并（包括squash），强制手动处理
• 本地开发环境保留自定义合并驱动（AutoMergeDriver）的功能，驱动会触发合并失败以强制手动合并
• GitHub仍能正常显示该文件的文本差异

现有配置的问题 #

你之前尝试的配置存在以下缺陷：

1. -text标记会让Git将文件视为二进制，虽然GitHub有时能识别JSON，但diff显示不稳定，且GitHub的squash合并逻辑仍会尝试自动处理可识别的文本文件
2. merge=AutoMergeDriver在GitHub上完全无效——GitHub不支持用户自定义的合并驱动，会直接忽略该配置，继续尝试自动合并

正确配置方案 #

修改仓库根目录的.gitattributes为：

**/mypath/*.json merge=fail diff=json

配置说明

• merge=fail：Git内置的合并驱动，当合并该文件时（分支间存在冲突修改）会直接返回失败，GitHub完全支持这个驱动，无论是常规合并还是squash合并，只要涉及该文件的冲突，都会被阻止，强制手动处理
• diff=json：明确指定使用JSON格式的diff规则，确保GitHub稳定显示该文件的文本差异，不会被识别为二进制文件

本地保留自定义驱动的设置 #

开发者在本地环境中，可通过以下步骤覆盖仓库的merge=fail配置，使用自定义的AutoMergeDriver：

1. 在本地Git配置中注册你的合并驱动：

   git config --local merge.AutoMergeDriver.command "你的合并驱动执行命令"
   

2. 为目标文件指定使用自定义驱动（两种方式二选一）：
   • 方式一：在本地创建.gitattributes.local文件，添加：

     **/mypath/*.json merge=AutoMergeDriver
     

     然后在本地Git配置中启用该文件：

     git config --local include.path .gitattributes.local
     

   • 方式二：直接通过Git配置指定文件的合并驱动：

     git config --local "merge.**/mypath/*.json" AutoMergeDriver
     

这样配置后，本地合并时会使用你的自定义驱动触发失败，而GitHub端会通过merge=fail阻止自动合并（包括squash），同时diff=json确保文本差异正常显示。

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