Spring Tool Suite中仅导入选定Maven子模块失败的问题咨询

问题描述 #

在基于Eclipse构建的Spring Tool Suite（STS）中执行以下操作时出现异常：

• 操作流程：通过「导入>现有Maven项目」选择父pom.xml所在的根目录，在弹出的项目树中仅勾选一个子模块，点击完成后，所有未勾选的模块文件夹仍被导入到工作区
• 相关截图说明：
  • 选择Maven项目界面：展示父项目下的多个子模块，仅单个子模块被勾选
  • 工作区结果界面：所有子模块的文件夹都出现在工作区中
  • 配置检测界面：右键执行「Configure>Configure and Detect Nested Projects」后，未勾选的模块文件夹未被识别为Maven项目，但源码文件已存在于工作区

2023年2月24日补充疑问：上述情况是否正常？是否无法仅导入勾选的源码？同时对GitHub仓库eugenp/tutorials中「Working with the IDE」章节的描述存疑："When you're working with an individual module, there's no need to import all of them (or build all of them) - you can simply import that particular module in either Eclipse or IntelliJ."

原因分析 #

1. Eclipse/STS的导入机制特性：当选择父pom的根目录作为导入源时，IDE会默认将根目录下的所有文件夹作为普通文件资源导入工作区，无论是否勾选子模块。只有勾选的子模块会被配置为Maven项目（带有Maven标识、构建配置），未勾选的只是单纯的文件夹资源。
2. 路径选择的混淆：用户选择的是父项目根目录，而非目标子模块的独立目录，导致IDE将整个父目录下的内容都纳入工作区，而非仅勾选的Maven项目。

解决方案：仅导入目标子模块 #

• 直接导入子模块目录：不要选择父pom根目录，而是找到目标子模块的文件夹（该文件夹下有自身的pom.xml），以此作为导入路径执行「现有Maven项目」导入操作，此时IDE只会导入该子模块的内容，不会带入其他子模块文件夹。
• 清理已导入的多余文件夹：如果已经导入了父目录，可右键工作区中不需要的子模块文件夹 → 「Delete」，根据需求选择仅从工作区移除，或同时删除本地磁盘文件。
• 调整导入设置：在导入向导的高级选项中，取消勾选「Import nested projects」相关设置，避免IDE自动导入父目录下的所有嵌套文件夹。

补充疑问解答 #

• 该情况属于正常现象：未勾选的模块只是作为普通文件夹存在于工作区，并未被配置为Maven项目（无Maven依赖管理、构建生命周期），本质上只是文件资源，而非真正的项目。
• 可以仅导入勾选的源码：按照上述「直接导入子模块目录」的方法，就能实现只导入目标子模块的源码，不会带入其他子模块的内容。

参考文档说明 #

GitHub仓库eugenp/tutorials中提到的「import that particular module」，指的是直接导入子模块自身的独立目录，而非通过父pom目录选择子模块。这种操作方式下，IDE只会导入该子模块的内容，完全符合文档描述的「无需导入所有模块」的要求。

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