当前位置：首页 > news >正文

Ruoyi-Vue-Plus 修改包名、模块名、项目名

news 2025/8/11 6:24:26

效果对比

修改包名

选中需要修改的包名，右键选择重命名（快捷键：Shift+fn+F6）
选择所有目录
选择重构
- 重构软件包耗时较长，请耐心等待！
- 如果需要快速修改多模块中的多级包名，可以参考：idea快捷变更包名
- 注意：在多模块的公共包名上选择重命名时，可以选择修改所有目录还是所选模块中的所有目录。但是若在某一模块的专属包名上选择重命名时，只能修改本模块下的包名，即便你修改的是公共包名，其他模块下的公共包名也不会有变化
  - 例如：在ruoyi-admin模块中选择org或者dromara包进行重命名时，会有弹窗让你选择修改所有目录还是所选模块中的所有目录（参见上面步骤2的截图）。而如果在ruoyi-admin模块中选择web包进行重命名时，则没有选择修改范围的弹窗，因为web包是ruoyi-admin模块的专属包
如需继续重命名其他软件包，则重复上述步骤即可
修改import路径：选中项目名，右键选择在文件中替换（快捷键：ctrl+shift+R）
- 选中正则表达式并在搜索框中输入^import\s+org\.dromara\.(admin|common|extend|modules)(\..*)?;
- 如果修改的是公共包，则需要选择在项目，如果修改的是某一模块内的专属包，则需要选择模块或者目录，大家根据自己的情况情况进行选择，因为我修改的是公共包，所以这里直接选择在项目，输入新的包名，点击替换全部
如果文件中错误的import语句仍然存在，可以使用IDEA的优化 import功能快速整理项目中所有的import语句
优化 import功能的作用是删除当前文件或整个项目中未使用的 import，并自动整理导入顺序
修改pom文件
- 否则会有类似Java文件不在源根下的错误提示
- 推荐但不强制：在Spring Boot项目中，groupId和包名不需要完全一致，但通常建议保持一定的关联性，使项目更易于理解和维护
之所以全局替换要分两步来做，而不是直接全局搜索org.dromara进行替换，是因为项目中有用到<groupId>为org.dromara开头的Maven依赖，如果图省劲直接全局替换，就可能导致这些Maven依赖报错，如下图：
修改SysTenantPackageBo类：这个地方很多文章中都没有提到，这里重点说明一下！
- 需要将红框中的包名修改为自己的包名
修改yml配置文件：主要是针对MyBatis-Plus扫描路径的修改
至此，项目就可以成功启动了