在现代前端开发中,尤其是微前端(Microfrontends)架构下,我们经常会遇到由于环境配置、打包策略(如开启 Hash)引发的偶发性 Bug。当我们在一个开发分支(如 dev)修复了这些问题,但又不想合并整个分支的冗余代码到稳定分支(如 4.0)时,git cherry-pick 就成了最强大的工具。
什么是 Cherry-Pick?
cherry-pick 的字面意思是"摘樱桃"。在 Git 中,它允许你选择某一个或几个特定的提交(Commit),并将它们作为新的提交应用到当前分支。
与 git merge 或 git rebase 不同,它不移动分支指针 ,也不合并整个历史路径,而是只复制改动的内容。
实战案例:解决微前端"时序竞争"Bug
背景
我们在 shili-dev 分支修复了两个由于开启打包文件名 Hash 导致的严重问题:
- 白屏 Bug:Hash 改变导致资源加载顺序变化引发的渲染错误。
- 用户信息丢失 :JS 加载变慢导致子应用错过了底座发出的
postMessage消息。
痛点
我们的 nms-dev4.0 分支是相对稳定的版本,shili-dev 中还有很多未测试完成的功能。如果直接 merge,会将不稳定的代码带入 4.0。
操作步骤
1. 锁定目标提交
首先,通过 git log 找到那两次关键修复的哈希值(Hash):
f896e0a:修复白屏。a5c1503:修复用户信息初始化逻辑。
2. 准备战场
确保当前工作区干净。如果有未提交的代码,先暂存:
bash
git stash
3. 实施"手术"
切换到目标分支,并按顺序"摘取"提交:
bash
git checkout nms-dev4.0
git cherry-pick f896e0a # 先同步基础修复
git cherry-pick a5c1503 # 再同步逻辑优化
4. 善后
切回原分支并恢复暂存区:
bash
git checkout shili-dev
git stash pop
为什么说 Cherry-Pick 是微前端开发的救星?
1. 解决时序竞争(Race Condition)
在微前端中,父子应用的通信往往依赖于极短的时间窗。当我们通过 cherry-pick 快速同步了"初始化兜底逻辑"(如从 localStorage 读取状态)后,子应用不再脆弱地依赖消息传递,极大地提升了系统的健壮性。
2. 保持分支纯净
在多版本并行的项目中,4.0 分支只需要"确定性"的修复。cherry-pick 让我们能够跳过无关的中间过程,只取结果。
进阶技巧与注意事项
连续提取
如果你有一连串的提交需要同步,可以使用范围提取:
bash
git cherry-pick A..B # 提取 A 之后到 B 之间的所有提交(不含 A)
git cherry-pick A^..B # 提取 A 到 B 之间的所有提交(含 A)
处理冲突
如果在同步过程中发生冲突,不要惊慌:
- 手动解决冲突。
git add <file>。git cherry-pick --continue。
撤销操作
如果"樱桃"摘错了,可以随时后悔:
bash
git cherry-pick --abort
总结
Git Cherry-Pick 不仅仅是一个命令,更是一种精细化版本管理的思维。在处理类似"打包 Hash 引起的副作用"这类特定问题时,它能让我们在不破坏现有稳定架构的前提下,实现 Bug 修复的快速分发。
金句: 优秀的程序员不只是写出好代码,更要学会如何优雅地搬运好代码。