如何实现Git合并文本文件时按文件级处理，遵循特定替换规则？

针对你描述的需求——特殊目录下的文本文件合并时仅做文件级替换，且合并上游时遵循「上游改了本地没改则用上游，本地改了则留本地」的规则，最优方案是通过Git自定义合并驱动实现，具体步骤如下：

1. 配置文件级合并规则映射 #

在仓库根目录创建或修改.gitattributes文件，为目标目录的所有文件指定自定义合并驱动：

# 替换为你的实际特殊目录路径
special-dir/** merge=ours-when-local-modified

这个配置会让Git处理该目录下的所有文件时，使用我们定义的ours-when-local-modified合并驱动，而非默认的文本行级合并逻辑。

2. 定义自定义合并驱动逻辑 #

在仓库的.git/config文件中添加以下配置，实现需求中的分支选择逻辑：

[merge "ours-when-local-modified"]
    name = Keep local version if modified, else use upstream
    driver = if git diff --quiet HEAD -- %A; then cat %B > %A; else cat %A > %A; fi

驱动逻辑说明： #

• git diff --quiet HEAD -- %A：检查当前分支（下游）的目标文件（%A代表当前分支的文件路径）相对于HEAD是否有修改
• 如果无修改（返回值为0），则将上游分支的文件（%B代表上游分支的文件路径）覆盖到当前分支的文件中
• 如果有修改（返回值非0），则保留当前分支的文件内容（用自身覆盖自身，相当于不做变更）

3. 验证配置有效性 #

可以通过以下步骤测试：

• 在下游分支修改special-dir下的某个文件，提交变更
• 在上游分支修改同一个文件，提交变更
• 从上游合并到下游，此时应该保留下游的修改版本
• 若下游未修改该文件，合并上游的修改后，文件会被替换为上游版本

注意事项 #

• 该配置是仓库级的，其他协作者克隆仓库后，需要同步.gitattributes文件，并手动添加.git/config中的驱动配置
• 确保目标文件不会被重命名或移动，否则规则会失效（符合你描述的场景）

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