重命名Maven模块需同步更新Maven坐标与IDEA项目结构：先改pom.xml和目录名，再修正父工程及依赖模块的pom.xml，最后通过Project Structure绑定源路径并刷新验证。

在多模块Maven项目中，你想把user-service模块重命名为auth-service，但直接右键Rename后发现依赖它的order-service编译报红、pom.xml里还写着旧名字、.iml文件路径错乱——这不是操作失败，而是IDEA默认重构没触达Maven语义层。

确认重命名影响范围

按下 Ctrl+Shift+Alt+P（Windows/Linux）或 Cmd+Shift+Option+P（macOS），强制唤出Refactor Preview窗口。这个预览会列出所有将被修改的文件：包括当前模块的.iml、pom.xml、父工程pom.xml中的条目，以及所有import该模块类的Java文件。如果列表里没出现父pom.xml或order-service的pom.xml，说明IDEA没识别到跨模块引用关系，必须手动介入。

注意：Preview窗口里显示“0处引用”的方法名或类名，不代表真的没被调用——它只扫描静态引用，不处理反射、Spring Bean名称、@Value("${xxx}")等动态绑定。

同步更新Maven坐标与磁盘目录

第一步：打开待重命名模块的pom.xml，将user-service改为auth-service，保存文件。

第二步：在项目视图中右键该模块 → Refactor → Rename → 输入auth-service → 勾选【同时重命名目录】 → 点击重构。这一步会同步改掉文件夹名、.iml文件名，并更新模块内所有源码路径配置。

第三步：打开父工程pom.xml，找到标签，把user-service删掉，新增auth-service。如果父pom里还定义了如，也一并替换为。

Idea Spark

根据用户提供的领域或兴趣生成项目创意。当用户询问项目想法、寻求灵感、说“应该做什么项目”或“给我点想法”等时使用。

下载

第四步：逐个检查其他模块（如order-service）的pom.xml，将中user-service全部替换为auth-service。漏改一处，Maven就会找不到依赖。

修复IDEA项目结构错位

方法一：若重命名后模块在侧边栏显示为普通文件夹（图标不是蓝色方块），说明内容根目录未绑定。按Ctrl+Alt+Shift+S打开Project Structure → 左侧选Modules → 选中auth-service → 右侧Sources页签 → 点击减号移除标红的旧路径 → 点击加号 → 选择刚重命名的auth-service文件夹 → 确保src/main/java被识别为Sources（绿色）。

方法二：若模块名与文件夹名仍不一致（比如显示名是auth-service但文件夹叫auth_service），直接在Project Structure → Modules → Name输入框里输入auth_service，点击Apply。IDEA会立即合并显示层级，不再出现双层嵌套。

刷新并验证依赖链

点击Maven工具窗口右上角的Reload project按钮（蓝色循环箭头图标）。这一步强制IDEA重新解析所有pom.xml，重建依赖图谱。

打开任意一个引用了auth-service中类的Java文件，光标停在类名上按Ctrl+Click。如果能跳转到auth-service模块内的源码，说明依赖已正确解析；如果弹出“Cannot find declaration to go to”，说明某处pom.xml漏改或路径映射错误。

在Terminal中执行mvn compile -pl auth-service，观察是否成功编译。再执行mvn compile -pl order-service，确认下游模块能正常编译通过。