基于 ruoyi-vue 开发的系统中同步社区框架升级时

在基于 ruoyi-vue 开发的系统中同步社区框架升级时，你可以通过以下步骤维护自己的分支：

1. 初始化与上游仓库的关联

首先需要将 ruoyi-vue 的官方仓库添加为你本地仓库的上游（upstream）：

# 添加官方仓库为上游
git remote add upstream https://gitee.com/y_project/RuoYi-Vue.git

# 验证上游仓库是否添加成功
git remote -v

2. 定期拉取上游更新

在每次升级前，先同步官方仓库的最新代码：

# 切换到主分支（通常是 master 或 main）
git checkout master

# 拉取上游仓库的最新代码
git fetch upstream

# 查看上游与本地的差异
git log HEAD..upstream/master --oneline

3. 创建升级分支

为避免直接在主分支操作导致风险，创建一个临时升级分支：

# 创建并切换到升级分支
git checkout -b upgrade-ruoyi

# 将上游代码合并到当前分支
git merge upstream/master

4. 解决冲突

合并时可能出现冲突，需要手动解决：

1. 查看冲突文件：

   git status
   

2. 编辑冲突文件：找到标记为冲突的部分（<<<<<<<、=======、>>>>>>>），根据你的业务需求保留代码。
3. 标记冲突已解决：

   git add <冲突文件路径>
   

4. 继续合并：

   git commit -m "Merge upstream changes and resolve conflicts"
   

5. 测试升级后的代码

升级完成后，务必进行全面测试：

# 启动项目进行测试
npm install
npm run dev

检查功能是否正常、样式是否有偏差、接口是否兼容等。

6. 合并到主分支并推送

测试通过后，将升级分支合并到主分支：

# 切换回主分支
git checkout master

# 合并升级分支
git merge upgrade-ruoyi

# 推送到你的远程仓库
git push origin master

7. 删除临时分支

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

git branch -d upgrade-ruoyi

8. 长期维护建议

• 定期同步：每隔1-2个月同步一次官方更新，避免积累过多差异。
• 提交规范：开发业务功能时，提交信息需清晰描述改动内容，便于后续追溯。
• 保留记录：维护一个 UPGRADE.md 文件，记录每次升级的时间、版本号、修改点和遇到的问题。

常见问题处理

• 冲突过多：如果冲突难以解决，考虑是否需要简化业务代码或调整架构。
• 版本不兼容：若官方升级涉及重大变更（如依赖库版本更新），需评估升级成本，必要时分批升级。

通过以上流程，你可以高效、安全地同步 ruoyi-vue 框架的更新，同时保留自己的业务代码。