本篇文章介绍完整的同步流程，如果你的项目当时已经把.git文件删了，那么建议你完成下述前置步骤后手动迁移。
前置条件：设置origin为团队仓库地址、设置upstream为vben开源仓库地址：
设置origin为团队仓库地址：
git remote set-url xxx
设置upstream（上游仓库地址）为vben开源仓库地址：
git remote add upstream https://github.com/vbenjs/vue-vben-admin.git
✅ 方案一: merge （推荐）
适用于多人协作，安全，但是 git log --graph 分叉多不整洁
# 1. 拉取 upstream 最新代码
git fetch upstream
# 2. 切换到本地 main，确保是最新
git checkout main
git pull origin main
# 3. 新建临时分支（比如 sync-upstream）
git checkout -b sync-upstream
# 4. 在临时分支上合并 upstream/main
git merge upstream/main
# 5. 解决冲突，确认代码无误后提交
# 6. 切回 main 分支
git checkout main
# 7. 将临时分支变更合并到 main
git merge sync-upstream
# 8. 推送 main 到远程
git push origin main
# 9. （可选）删除临时分支
git branch -d sync-upstream
🚫 方案二: rebase （不推荐）
rebase适合在个人分支整理提交历史、保持线性清晰时使用，优点是提交历史干净整洁，缺点是会改写历史，强制推送可能导致团队协作冲突。
# 1. 拉取上游仓库最新代码到本地（fetch 不会自动合并）
git fetch upstream
# 2. 切换到自己的 main 分支
git checkout main
# 3. 确保本地 main 是最新的（拉取自己远程 origin）
git pull origin main
# 4. 基于 upstream/main 执行 rebase
git rebase upstream/main
# 5. 解决冲突（如果有），按照提示编辑冲突文件后
git add <冲突解决的文件>
git rebase --continue
# 6. 完成后强制推送到自己远程仓库（因为提交历史被改写）
git push origin main --force-with-lease
✅ 方案三：cherry-pick （推荐）
git cherry-pick <commit> 是将某个特定的提交（commit）单独“摘取”到当前分支，等同于把那个提交的改动复制一份应用过来，不会带历史上的其他提交。
cherry-pick 的场景和merge、rebase不同：
-
只想同步上游仓库中的部分特定提交，而不是全部提交。
-
避免一次性合并大量代码，减小风险。
-
需要从上游挑选几个重要修复、特性，快速应用到自己的分支。
-
你的本地分支改动很多，无法做干净的 merge 或 rebase。
# 1. 拉取上游最新代码（fetch 但不合并）
git fetch upstream
# 2. 切换到你的 main 分支
git checkout main
# 3. 确保自己的 main 是最新的（拉 origin）
git pull origin main
# 4. 挑选你需要的上游提交依次应用
git cherry-pick abc1234
git cherry-pick def5678
# 5. 解决 cherry-pick 过程中可能出现的冲突
# 手动编辑冲突文件后：
git add <冲突解决的文件>
git cherry-pick --continue
# 6. 处理完所有 cherry-pick 后，推送到远程
git push origin main
总结
| 场景 | 推荐操作 | 优点 | 缺点 |
|---|---|---|---|
| 团队多人协作开发 | git merge | 安全不改写历史，适合多人协作；冲突较易追踪 | 提交历史可能较多、分叉，显得杂乱 |
| 个人项目 / 整理本地提交历史 | git rebase | 提交历史线性、清晰；便于查看每次改动 | 改写历史，需谨慎使用；多人开发中易引发冲突 |
| 只需要上游某些关键修复或功能，不需全部更新 | git cherry-pick | 精准引入特定提交；无需同步整个 upstream | 操作繁琐；多个提交需多次 cherry-pick；容易冲突 |
此外
- 有精力的话持续关注vben项目，有新功能、bug修复、性能优化等可以考虑同步到自己的分支。
- 业务代码尽量都写在apps目录下，如果迫不得已动了apps外的代码需要记录，方便后续同步。
