Git：同步父仓库时排除特定文件并避免合并冲突的方法

针对你提到的WidgetsParent和WidgetsChild同步场景，这里有几个实用方案，能帮你减少merge时的冲突，同时保留自定义修改：

1. 用.gitattributes指定特定文件的合并策略 #

对于需要保留自定义修改的文件（比如配置文件、package.json），可以通过Git的合并规则自动保留Child的版本，避免冲突：

• 在WidgetsChild仓库根目录创建/编辑.gitattributes文件，添加规则：

  # 对自定义配置文件使用"ours"策略，merge时自动保留Child版本
  config/custom-config.js merge=ours
  # 对package.json可单独配置，按需保留自定义内容
  package.json merge=custom-merge
  

• 全局配置ours合并驱动（执行一次即可）：

  git config --global merge.ours.driver true
  

• 若要精细处理package.json（比如保留Child的scripts，合并Parent的依赖更新），可以写个简单脚本作为合并驱动：

  1. 创建merge-package-json.sh脚本，用jq工具合并两个版本的package.json（保留Child的scripts字段，合并dependencies）
  2. 配置Git使用该脚本：

     git config --global merge.custom-merge.driver "./merge-package-json.sh %A %B %O"
     

2. 用git-filter-repo过滤不需要的文件/文件夹 #

如果WidgetsChild移除了Parent里的某些文件夹，每次merge都会因这些文件夹的变更产生冲突，git-filter-repo可以帮你在同步前先剔除这些内容：

操作步骤：

• 拉取Parent的最新代码：

  git fetch widgets-parent
  

• 创建临时分支，基于Parent主分支过滤掉不需要的文件夹：

  git checkout -b temp-parent widgets-parent/main
  git filter-repo --path "unwanted-folder/" --path "another-unwanted-dir/" --invert-paths
  

• 合并清理后的临时分支到Child主分支：

  git checkout main
  git merge temp-parent
  

• 合并完成后删除临时分支：

  git branch -D temp-parent
  

注意：git-filter-repo会重写分支历史，这个临时分支仅用于本地合并，不要推送到远程仓库。

3. 分离同步分支与自定义分支 #

把同步操作和自定义修改分开到不同分支，能让流程更清晰，减少冲突：

• WidgetsChild的main分支仅用于同步Parent，不做任何自定义修改：

  git checkout main
  git merge widgets-parent/main
  

• 所有自定义修改都放在custom分支：

  git checkout custom
  git rebase main
  

  每次同步Parent后，只需在custom分支执行一次rebase，解决可能的冲突；开启Git的rerere功能，还能自动记住冲突解决方式，避免重复操作：

  git config --global rerere.enabled true
  

总结 #

• 个别文件有自定义修改时，.gitattributes合并策略是最简单的方案；
• 需要批量移除Parent文件夹时，git-filter-repo能有效规避这类冲突；
• 分离分支+rerere的方式适合长期维护场景，流程更可控。

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