一、背景说明
在 Windows 环境下使用Git Bash开发时，经常会遇到这样的需求：
- 项目基于某个上游开源仓库
- 下游仓库只保留并改造了部分目录
- 希望只同步上游某个目录
- 并且只同步指定提交范围
- 同时上下游目录结构还不一致
如果直接git merge或git cherry-pick，往往会导致大量冲突，甚至污染仓库历史。
本文将介绍一种安全、可控、工程化的解决方案。
二、实际场景说明
上游仓库
https://gitee.com/yudaocode/yudao-ui-admin-vben.git需要同步的目录：
apps/web-ele下游仓库
apps/web-admin同步的提交范围
17d5d1b8 → 36aa1953三、为什么不推荐 merge / cherry-pick？
| 方式 | 问题 |
|---|---|
| git merge | 引入大量无关提交 |
| git cherry-pick | 目录不同，冲突极多 |
| 手动复制 | 无法追溯历史，不可回滚 |
结论：都不适合该场景。
四、推荐解决方案（核心思路）
git format-patch + 路径重写 + git apply（3-way）
该方案的优势：
- 精确控制提交范围
- 只作用于指定目录
- 不污染下游 Git 历史
- 冲突集中，便于人工处理
- 非常适合 Fork / 定制项目长期维护
五、准备工作（Git Bash）
1️⃣ 打开 Git Bash
在下游仓库根目录打开 Git Bash，例如：
D:/Develop/qian-duoduo-s2b2c/qian-duoduo-s2b2c-ui2️⃣ 添加上游仓库 remote
gitremoteaddupstream-yudao https://gitee.com/yudaocode/yudao-ui-admin-vben.gitgitfetch upstream-yudao验证提交是否存在：
gitlog upstream-yudao/master --oneline|grep36aa1953六、导出指定目录的补丁（Git Bash）
⚠️注意：git format-patch 必须在 Git 仓库目录中执行
gitformat-patch\17d5d1b8^..36aa1953\--stdout\-- apps/web-ele\>../web-ele-patches/web-ele.patch参数说明：
17d5d1b8^..36aa1953：包含起始提交-- apps/web-ele：只导出该目录改动--stdout：生成单一 patch 文件
七、使用 Git Bash 重写目录路径（关键步骤）
因为上下游目录不同，需要修改补丁中的路径。
1️⃣ 使用 sed（Git Bash 自带）
sed-i's#apps/web-ele#apps/web-admin#g'../web-ele-patches/web-ele.patch校验是否替换成功：
grepweb-admin../web-ele-patches/web-ele.patch|head八、应用补丁（推荐 3-way）
1️⃣ 创建同步分支
gitcheckout -b sync-web-ele-to-admin2️⃣ 使用 3-way apply（Git Bash）
gitapply --3way../web-ele-patches/web-ele.patchGit 会自动：
- 尝试三方合并
- 能合的直接合
- 冲突的文件标记为
U，等待人工处理
九、处理冲突（新手重点）
1️⃣ 查看冲突文件
gitstatus示例：
U apps/web-admin/src/views/mall/promotion/article/modules/form.vue U apps/web-admin/src/views/mall/promotion/discountActivity/modules/form.vue2️⃣ 手动解决冲突
打开文件，会看到以下标记：
<<<<<<< ours 下游代码 ======= 上游代码 >>>>>>> theirs合并建议：
- 保留下游整体结构
- 合并上游新增字段、校验规则、表单项
- 不直接覆盖下游业务逻辑
3️⃣ 冲突处理完成后检查
gitdiffgitstatus确保：
- 没有
<<<<<<< - 没有
U状态文件
十、提交同步结果
gitcommit -m"sync: yudao web-ele -> web-admin source: yudao-ui-admin-vben range: 17d5d1b8..36aa1953 "十一、方案总结
| 优点 | 说明 |
|---|---|
| 精准 | 只同步指定目录 |
| 安全 | 不污染主分支 |
| 可维护 | 适合长期同步 |
| 工程化 | 企业级做法 |
十二、写在最后
Git Bash + format-patch，是 Windows 环境下处理复杂同步问题的利器。
如果你维护的是 Fork 项目或定制版本，
这套方案非常值得长期使用。
如果你后面还想写进阶篇，我可以继续帮你出：
- ✅「多次同步如何避免重复 patch」
- ✅「如何自动化同步（脚本 + CI）」
- ✅「什么时候该放弃同步，直接 Fork 重构」
这篇已经是CSDN + Git Bash + 实战的标准答案级别了。
