IDEA项目Module X must not contain source root Y. The root already belongs to module Z

维护老项目是件有趣的事情，会遇见很多罕见的场景，比如这次整理的案例。

目录

1、IDEA项目错误信息

2、错误原因分析与解决

3、实践总结

---

运行环境：

• Windows-7-Ultimate-x64
• OracleJDK-1.8_u201
• IntelliJ IDEA Community Edition 2022.2.2
• Maven-3.6.3

1、IDEA项目错误信息

原文：Module "xxx-parent" must not contain source root "\xxx-parent\xxx-sdk\src\main\java". The root already belongs to module "xxx-sdk".

译文：模块 "xxx-parent"不能包含 source (的) root (指定)项目 "\xxx-parent\xxx-sdk\src\main\java"，(因为)root已属于(子)模块 "xxx-sdk"。

2、错误原因分析与解决

        由于项目属于多级包含，且其下的子模块很少改动。这次“触雷”是因为重构，在新增一个子模块后，无法保存。

        根据报错信息，经过对项目的 parent 进行排查，发现在 xxx-parent 下也有对子模块指定source目录，取消 xxx-parent 模块下的 source目录 设置即可。

3、实践总结

• 处理老项目是件“涨知识”的事儿，经验难得；​​​​​​
• 不应在 父工程中设置 source目录，而是在最底的子工程中设置 source目录；
• 项目提交到 git仓库前，确保能正常编译、打包；
• 开发前尽可能多地思考，并合理设置项目结构；