如何快速批量重构项目模块中的包路径？

需求示例：将项目中多模块的包路径从旧格式批量替换为新格式
旧结构：

Project/
├── a/
│   ├── core/
│   │   └── com.blabla.hi.sofbs
│   └── api/
│       └── com.blabla.hi.sofbs
└── b/
    ├── core/
    │   └── com.blabla.hi.sofbq
    └── api/
        └── com.blabla.hi.sofbq

改为：

Project/
├── a/
│   ├── core/
│   │   └── us.bla.sofbs
│   └── api/
│       └── us.bla.sofbs
└── b/
    ├── core/
    │   └── us.bla.sofbq
    └── api/
        └── us.bla.sofbq

以下是几种无需逐个包操作的高效方案：

1. IDE全局重构（推荐，最省心） #

主流IDE（IntelliJ IDEA、Eclipse）都支持跨模块的包名全局重构：

• 打开项目后，在项目视图中找到旧包的顶层节点（比如com.blabla.hi）
• 右键选择「重构」→「重命名」，输入新包名us.bla
• 勾选搜索整个项目、包含子模块、搜索注释和字符串等选项（根据需要调整）
• 预览所有待修改的内容，确认无误后执行重构

IDE会自动处理所有Java文件的import语句、类的包声明、注解中的包引用，同时自动调整目录结构，无需手动修改文件夹。

2. 命令行批量处理 #

适合习惯终端操作的场景，分两步：修改文件内容、调整目录结构

修改文件内容 #

用find+sed批量替换所有Java文件中的旧包名：

# 在Project目录下执行，替换com.blabla.hi为us.bla
find ./ -name "*.java" -type f -exec sed -i 's/com.blabla.hi/us.bla/g' {} \;

调整目录结构 #

批量重命名包对应的目录，并清理空目录：

# 找到所有旧包的底层目录，替换路径后移动
find ./ -type d -name "hi" | while read dir; do
    new_dir=$(echo $dir | sed 's/com\/blabla\/hi/us\/bla/g')
    mkdir -p $(dirname $new_dir)
    mv "$dir" "$new_dir"
done
# 删除空的旧目录
find ./ -type d -empty -delete

3. 构建工具插件辅助（Maven/Gradle） #

如果项目用Maven或Gradle管理，可以通过插件自动化处理：

• Maven：使用maven-replacer-plugin，在父pom中配置替换规则，执行mvn replacer:replace批量替换文件内容，再配合maven-antrun-plugin调整目录结构。
• Gradle：自定义任务，结合Copy任务和ReplaceTokens插件替换文件内容，再通过delete和mkdir任务调整目录。

注意事项 #

• 操作前务必备份项目，或确保代码在Git等版本控制系统中，方便回滚。
• 执行后一定要重新编译项目，检查是否有遗漏或误替换导致的编译错误。
• 若项目中有配置文件、XML或其他非Java文件包含包名引用，需额外检查或纳入替换范围。

内容的提问来源于stack exchange，提问作者SB_STOPDL