从Eclipse迁移至IntelliJ：项目组织与依赖问题咨询

刚从Eclipse转IntelliJ的时候，真的很容易把Module、Package和普通目录搞混——我当初第一次用IntelliJ搭项目时，也犯过把Module当成Eclipse Package的错误，结果跑代码时各种依赖找不到，折腾了好一会儿才搞明白。下面就给你拆解清楚这几个概念，以及解决你当前问题的步骤，还有正确的项目组织方式。

• Module：这是最容易搞错的点！IntelliJ的Module等同于Eclipse里的Project，而不是Package。每个Module是一个可以独立编译、运行、管理依赖的子单元，大型项目会拆成多个Module来解耦。
• Package：和Eclipse里的Package完全一样，就是Java用来组织类的命名空间，必须放在「Source Root」（IntelliJ里标蓝色的目录，比如src/main/java）下面，用来避免类名冲突，结构上是层级化的。
• 普通目录：没被标记为任何特殊类型的目录，IntelliJ不会把这里的文件当作源码编译，一般用来放文档、临时文件或者非代码资源。

1. 把Module当成了Eclipse的Package，创建了多个Module但没配置依赖：比如你以为建了个com.example.service的Module，其实它是一个独立的子项目，主类所在的Module如果没依赖它，自然找不到里面的类。
2. Package建在了普通目录下：如果你的Package没放在Source Root里，IntelliJ不会编译这些类，主类调用时就会报找不到的错误。

步骤1：检查项目结构 #

打开File > Project Structure（快捷键Ctrl+Alt+Shift+S），切换到「Modules」标签页，先搞清楚当前项目里哪些是真正的Module，哪些是误创建的。

情况A：误把Package当成Module创建了 #

• 删掉多余的Module：在Modules列表里选中错误的Module，点击左上角的减号-删除。
• 把对应目录标记为Source Root：回到Project视图，右键这个目录，选择Mark Directory as > Sources Root，这样里面的Package就会被IntelliJ正确识别为Java源码目录。

情况B：Module之间缺少依赖配置 #

假设你的主类在Module A里，需要调用Module B的类：

• 在Project Structure的Modules里选中Module A，切换到「Dependencies」标签页。
• 点击右上角的加号+，选择Module Dependency，然后选中Module B添加进去。
• 点击「Apply」和「OK」，之后主类就能找到Module B里的类了。

情况C：Package在普通目录下 #

• 右键存放Package的目录，选择Mark Directory as > Sources Root，IntelliJ会自动把这个目录下的Package纳入编译路径，依赖问题就会消失。

1. 单Module项目（适合小型项目） #

这是最常用的方式，整个项目就是一个Module：

• 核心源码放在src/main/java（标记为Sources Root），里面按业务逻辑建不同的Package，比如：
  • com.yourcompany.project.controller：放控制器类
  • com.yourcompany.project.service：放业务逻辑类
  • com.yourcompany.project.dao：放数据访问类
• 资源文件放在src/main/resources（标记为Resources Root），比如配置文件、静态资源。
• 普通目录比如docs、temp用来放辅助文件，不用做任何标记。

2. 多Module项目（适合大型项目） #

当项目规模较大，需要拆分多个子模块时使用：

• 先创建一个Root Project（作为容器），然后在下面创建多个Module，比如core（核心业务）、web（Web层）、common（工具类）。
• 每个Module有自己的Source Root和Package结构，比如core模块的Package前缀是com.yourcompany.core，web模块是com.yourcompany.web。
• 通过Module Dependency来管理模块间的调用：比如web模块依赖core模块，就在web的Dependencies里添加core模块。
• 注意：不要随便创建Module，只有当模块需要独立编译、打包或者被其他项目引用时，才考虑拆成Module，否则用Package组织就够了。

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