如何在IntelliJ v2018.3中配置含子项目的项目以启用智能提示

Hey there, I’ve run into this exact scenario before with multi-module Gradle projects where the root didn’t have its own build.gradle—here’s how I fixed the Intellisense and package highlighting issues in IntelliJ 2018.3:

The biggest mistake here is opening the root folder directly (since it has no Gradle config). Instead:

• Go to File → Open, then select one of your subproject’s build.gradle files (not the root folder).
• In the import window, check Use auto-import, select the Gradle JVM that matches your project’s JDK version, then click OK. This tells IntelliJ to load the Gradle structure from the subproject and recognize all related modules.

If you already have the root project open, you can add subprojects one by one:

• Right-click the root directory in the Project view → New → Module.
• Choose Import Gradle Project from the list, navigate to another subproject’s build.gradle, and follow the prompts to complete the import. Repeat for all subprojects.

Corrupted cache is almost always a culprit for broken Intellisense:

• Go to File → Invalidate Caches / Restart.
• Select Invalidate and Restart in the popup. Let IntelliJ restart and rebuild its indexes—this usually clears up red package highlights and missing suggestions.

Double-check that IntelliJ recognizes your modules correctly:

• Open File → Project Structure:
  • Under the Modules tab, confirm each subproject has its source directories marked as Sources (blue folder icon), test directories as Tests (green), and dependencies are loaded properly.
  • Under the Project tab, make sure the Project SDK matches your project’s JDK, and the Project language level aligns with what’s defined in your subprojects’ Gradle files.

Even if your root project doesn’t need build logic, adding a minimal build.gradle helps IntelliJ understand the multi-module structure better:
Create a build.gradle file in the root directory with this simple content:

// Root build.gradle to help IntelliJ recognize multi-module setup
allprojects {
    repositories {
        mavenCentral()
        // Add any other repositories your subprojects use (e.g., jcenter)
    }
}

Then re-import the entire project by right-clicking the root build.gradle → Import Gradle Project.

One last check: Make sure the Gradle plugin is enabled in IntelliJ (File → Settings → Plugins, confirm "Gradle" is checked).

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