xinyin025/RuoYi-Vue-Plus

Fork 0

mirror of https://github.com/dromara/RuoYi-Vue-Plus.git synced 2025-09-26 21:26:39 +08:00

Xuhf 0940f6d504 合并上游v5.4.0更新，保留PMS模块和编译优化配置

2025-05-31 20:02:30 +08:00

5.2 KiB

Raw Blame History

RuoYi-Vue-Plus 代码升级操作指南

📋 升级概述

本指南将帮助您完成从当前版本到上游最新版本（v5.4.0）的升级。

🔍 当前状态

本地仓库: 已包含PMS模块和编译优化配置
上游仓库: https://github.com/dromara/RuoYi-Vue-Plus (v5.4.0)
个人仓库: https://github.com/figo990/RuoYi-Vue-Plus
升级分支: upgrade-to-5.4.0

🚀 详细操作步骤

第一步：处理合并冲突

当前已经开始合并上游代码，但出现了大量冲突。您需要在Cursor中逐个解决这些冲突：

1.1 查看冲突文件列表

git status

1.2 使用Cursor的冲突解决工具

在Cursor中打开有冲突的文件
您会看到类似这样的冲突标记：

<<<<<<< HEAD
您的代码
=======
上游代码
>>>>>>> upstream/5.X

1.3 冲突解决策略

核心原则: 保留您的PMS模块和优化配置，同时接受上游的框架更新

重要文件处理建议:

保留您的修改 (选择HEAD版本):
- ruoyi-modules/ruoyi-pms/ 下的所有文件
- pom-dev.xml、ruoyi-admin/pom-dev.xml、ruoyi-modules/pom-dev.xml
- .vscode/ 下的配置文件
- script/sql/pms/ 下的SQL文件
接受上游更新 (选择upstream版本):
- ruoyi-common/ 下的框架核心文件
- ruoyi-modules/ruoyi-system/ 下的系统模块文件
- ruoyi-modules/ruoyi-demo/ 下的示例文件
- ruoyi-modules/ruoyi-generator/ 下的代码生成器文件
手动合并 (需要仔细处理):
- pom.xml - 保留您的MySQL驱动配置，接受其他依赖更新
- ruoyi-modules/pom.xml - 保留PMS模块引用，接受其他更新
- .gitignore - 合并两个版本的忽略规则

第二步：使用Cursor快速解决冲突

2.1 批量处理策略

在Cursor中使用以下快捷键：

Ctrl+Shift+P → 搜索 "Git: Resolve Conflicts"
或者使用Source Control面板的冲突解决工具

2.2 自动化脚本处理

创建一个PowerShell脚本来批量处理简单冲突：

# 自动接受上游版本的文件（框架核心文件）
$acceptUpstream = @(
    "ruoyi-common/ruoyi-common-core/src/main/java/org/dromara/common/core/domain/model/RegisterBody.java",
    "ruoyi-common/ruoyi-common-core/src/main/java/org/dromara/common/core/enums/DeviceType.java",
    "ruoyi-modules/ruoyi-demo/src/main/java/org/dromara/demo/controller/RedisCacheController.java"
    # ... 更多文件
)

foreach ($file in $acceptUpstream) {
    if (Test-Path $file) {
        git checkout --theirs $file
        git add $file
    }
}

# 自动保留本地版本的文件（您的PMS模块）
$acceptLocal = @(
    "ruoyi-modules/ruoyi-pms/",
    "pom-dev.xml",
    "ruoyi-admin/pom-dev.xml",
    "ruoyi-modules/pom-dev.xml"
    # ... 更多文件
)

foreach ($file in $acceptLocal) {
    if (Test-Path $file) {
        git checkout --ours $file
        git add $file
    }
}

第三步：验证升级结果

3.1 编译测试

# 使用您的优化编译脚本
.\pms-compile.ps1

# 或者使用标准编译
mvn clean compile -pl ruoyi-admin

3.2 启动测试

# 使用您的优化启动脚本
.\dev-start.ps1

# 或者使用快速启动
.\quick-start.ps1

第四步：完成合并

4.1 提交合并结果

# 添加所有解决的冲突
git add .

# 提交合并
git commit -m "合并上游v5.4.0更新，保留PMS模块和编译优化配置"

4.2 推送到您的GitHub仓库

# 推送升级分支
git push origin upgrade-to-5.4.0

# 切换到主分支并合并
git checkout master
git merge upgrade-to-5.4.0
git push origin master

🔧 重要注意事项

保护您的自定义内容

PMS模块: 完全保留，这是您的核心业务模块
编译优化配置: 保留所有pom-dev.xml文件和编译脚本
VSCode配置: 保留.vscode/下的所有配置文件
数据库脚本: 保留script/sql/pms/下的所有SQL文件

接受框架更新

依赖版本: 接受上游的依赖版本更新
框架核心: 接受ruoyi-common下的所有更新
系统模块: 接受ruoyi-system的功能增强
安全更新: 接受所有安全相关的更新

手动检查项目

配置文件: 检查application.yml等配置文件
启动类: 检查RuoYiApplication.java
数据库连接: 确认MySQL驱动配置正确
菜单权限: 检查PMS模块的菜单是否正常

🚨 应急回滚方案

如果升级过程中出现问题，可以快速回滚：

# 取消当前合并
git merge --abort

# 回到升级前的状态
git checkout master
git reset --hard HEAD~1

# 删除升级分支
git branch -D upgrade-to-5.4.0

📞 技术支持

如果在升级过程中遇到问题：

查看冲突文件的具体内容
参考上游的更新日志
测试关键功能是否正常
保持PMS模块的完整性

🎯 升级后验证清单

项目能正常编译
应用能正常启动
PMS模块功能正常
系统基础功能正常
数据库连接正常
前端页面能正常访问
用户登录功能正常
菜单权限显示正常

升级完成后，您将拥有最新的框架功能，同时保留所有自定义的PMS模块和优化配置。

5.2 KiB Raw Blame History Unescape Escape