如何在IntelliJ中配置多Gradle模块以实现跨模块类导航

1. 修正Gradle依赖声明 #

如果两个模块属于同一个Gradle根项目，在ota模块的build.gradle中，将metasearch的依赖修改为项目依赖，格式如下：

// 替换原本的implementation "com.xxx:metasearch:版本号"写法
implementation project(':metasearch')

如果两个模块是独立导入、不属于同一个Gradle根项目，跳过这一步看后续配置。

2. 校验版本一致性 #

确保ota模块中声明的metasearch依赖版本号，和metasearch模块自身build.gradle中配置的version属性完全一致，版本不匹配时IDEA会优先拉取远端仓库的jar包，不会关联本地模块源码。

3. 调整IDEA Gradle配置 #

• 打开配置面板：Windows/Linux系统走File > Settings > Build, Execution, Deployment > Build Tools > Gradle，Mac系统走IntelliJ IDEA > Settings > Build, Execution, Deployment > Build Tools > Gradle
• 确认Build and run using、Run tests using选项设置为IntelliJ IDEA，部分版本需额外勾选Resolve modules from existing sources
• 可选勾选Download sources and documentation for dependencies，不影响本地模块关联但方便查看第三方依赖源码

4. 新增模块依赖（仅独立导入模块时需要） #

如果两个模块是分别导入工作区、不属于同一个Gradle根项目，手动添加模块依赖：

• 打开File > Project Structure > Modules
• 选中ota模块，切换到Dependencies标签
• 点击+号选择Module Dependency，勾选metasearch模块确认添加
• 将新增的metasearch模块依赖的优先级拖动到maven依赖之前，作用域设置为Implementation

5. 刷新依赖并重建索引 #

• 点击右侧边栏Gradle面板的刷新按钮，或右键项目选择Gradle > Reload Gradle Project，重新解析依赖关系
• 如果仍未生效，走File > Invalidate Caches...，勾选Clear file system cache and local history，点击Invalidate and Restart，等待重启后索引完成即可正常跳转

内容的提问来源于stack exchange，提问作者Mai Hữu Lợi