intellij idea中安全重命名必须使用refactor引擎：类重命名需勾选search in comments and strings；模块重命名必须同步改目录与pom.xml；方法/变量按可见范围选rename code/all occurrences；包重命名后需手动修正非java文件中的硬编码引用。
在IntelliJ IDEA中对Java类、方法或变量执行重命名操作时，若仅手动修改名称而不触发IDE的语义识别，会导致引用处全部失效，编译报错且难以批量修复。真正的安全重命名必须依赖IDEA内置的Refactor引擎，它能自动扫描并同步更新所有调用点、import语句、测试类名甚至Maven依赖中的模块引用。
重命名Java类（含文件+包路径）
第一步：在项目工具窗口中，右键点击目标.java文件 → 选择 Refactor → Rename（或直接按快捷键 Shift+F6）。
第二步：在弹出的对话框中输入新类名，勾选 Search in comments and strings（防止注释里残留旧名），不勾选 Rename tests（除非你确定测试类也需同步改名）。
第三步：点击 Refactor 后，IDEA会自动完成三件事：更新类声明、更新同名.java文件名、修正所有import语句中的包引用。这一步不可跳过，否则会出现“class not found”或“cannot resolve symbol”错误。
重命名模块（Module）
方法一：物理层+配置层同步改
在项目工具窗口中右键点击模块名 → 选择 Refactor → Rename → 勾选 Rename directory 和 Update references → 输入新模块名 → 点击 Refactor。
注意：【必须同时勾选Rename directory】，否则只改了IDEA里的显示名，磁盘上文件夹名和pom.xml中的
方法二：分步手动控制（适合复杂依赖场景）
先关闭IDEA → 用文件管理器重命名模块所在文件夹 → 重新打开项目 → 进入 File → Project Structure → Modules → 手动编辑模块名与路径 → 再打开对应pom.xml，把
重命名方法或变量（精准范围控制）
将光标定位到要重命名的方法名/变量名上 → 按 Shift+F6 → 在弹窗中输入新名称 → 下方出现两个关键选项：
Rename code occurrences：仅重命名当前文件内所有该符号的使用（推荐用于私有方法或局部变量）。
Rename all occurrences：跨文件搜索并替换全部引用（适用于public方法、static final常量等全局可见符号）。
如果该方法被多个子类重写，IDEA还会自动弹出提示是否重命名所有override实现——此时务必确认子类逻辑是否兼容新名，否则可能引发语义混淆。
重命名包（Package）
在项目工具窗口中切换到 Project → Packages 视图 → 右键目标包 → Refactor → Rename → 输入新包名（如com.example.old → com.example.new）→ 点击 Refactor。
IDEA会自动更新包声明、所有import语句、以及该包下所有类的package语句。但有一个隐藏陷阱：【如果包路径中存在非Java文件（如XML、properties），它们内部硬编码的旧包名不会被自动替换】，必须手动搜索整个项目，查找字符串“com.example.old”并逐一修正。
重命名文件（非Java源文件）
对.properties、.xml、.yml等非Java文件，右键 → Refactor → Rename File 即可。此操作仅改文件名，不涉及内容替换。
若该文件被Java代码以字符串形式加载（如ResourceBundle.getBundle("messages")），则需额外打开对应Java类，手动将字符串字面量同步更新，否则运行时报“MissingResourceException”。
