新电脑上IDEA 2018.3导入Maven项目后无src目录问题排查

我之前在老版本IDEA上也碰到过类似的Maven项目导入后看不到src目录的情况，结合你说的mvn compile能正常编译、Eclipse可以正常导入的信息，项目本身的结构和pom.xml肯定是没问题的，问题大概率出在IDEA的项目识别、目录标记或者缓存上。下面给你几个针对性的解决步骤：

1. 手动标记源目录（最直接的解决办法） #

有时候IDEA导入时没能自动识别Maven的标准目录结构，这时候手动标记就可以解决：

• 按下快捷键 Ctrl+Alt+Shift+S 打开Project Structure窗口
• 切换到「Modules」选项卡，选中你的项目模块
• 在右侧的「Sources」标签页里，找到src/main/java、src/main/resources这些目录，右键点击选择「Mark Directory as → Sources Root」；如果有测试目录，把src/test/java标记为「Test Sources Root」，src/test/resources标记为「Test Resources Root」
• 点击「Apply」和「OK」，回到项目视图应该就能看到src目录正常显示了

2. 检查Maven导入配置与IDEA的Maven设置 #

重新导入项目时，注意几个关键配置：

• 在「Import Project from External Model → Maven」的界面，务必勾选「Import Maven projects automatically」，这样IDEA会自动同步Maven的变化
• 如果你的项目有Maven Profiles，确认在这个界面选中了正确的Profile
• 另外检查IDEA的Maven全局设置：按下Ctrl+Alt+S打开Settings，找到「Build, Execution, Deployment → Build Tools → Maven」，确认「Maven home directory」是你本地安装的Maven版本（而不是IDEA自带的），「Settings file」和「Local repository」的路径也都正确

3. 清理IDEA全局缓存（解决顽固的识别问题） #

只删除.idea文件夹有时候不够，IDEA还有全局缓存可能导致异常：

• 点击顶部菜单栏的「File → Invalidate Caches / Restart」
• 在弹出的窗口选择「Invalidate and Restart」，等待IDEA重启完成后，再重新导入项目
• 这个操作会清除IDEA的所有缓存，能解决很多奇怪的项目识别bug

4. 检查pom.xml的特殊配置 #

虽然Eclipse能识别，但老版本IDEA对一些自定义配置的兼容性可能不好：

• 打开项目的pom.xml，检查<build>节点下有没有自定义的<sourceDirectory>或者<resources>配置，确认路径是正确的相对路径
• 如果是多模块项目，确认导入时选中了所有需要的模块，而不是只导入了父模块

额外建议 #

你的IDEA是2018.3版本，确实比较老旧了，官方已经停止对这个版本的维护，很多Maven相关的bug在后续版本中都被修复了。如果上面的方法都没能解决问题，可以考虑升级到更新的IDEA版本（比如2020.3及以上），应该能避免这类兼容性问题。

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