Android Studio正确导入新模块及从零搭建项目依赖问题排查

Hey there, let’s work through this problem together—missing modules in dependency settings and build errors are super common when restructuring a project from scratch, especially after ditching the default app module. Here’s a step-by-step solution, starting with the critical settings.gradle update you mentioned:

1. Update settings.gradle (The Root Cause 90% of the Time) #

Gradle only recognizes modules that are explicitly declared in this file. If you removed the app module and added new ones like testModule3, your old settings.gradle is probably still pointing to the deleted module.

Before (Example): #

include ':app'

After (Update with Your Modules): #

// List ALL your custom modules here—separate with commas
include ':testModule3', ':yourOtherModule1', ':yourOtherModule2'

// If your modules are nested in subfolders (e.g., a "features" directory), use this format:
// include ':features:testModule3'
// project(':features:testModule3').projectDir = file('features/testModule3')

Why this works: This tells Gradle to scan and load each listed module into your project. Without this, the Module Settings window will never see your modules, no matter what you do.

2. Verify Module Build Configurations #

Make sure each of your modules has a valid Android plugin in its build.gradle (Module level):

• For a library module (most common for shared code):

  plugins {
      id 'com.android.library'
      id 'org.jetbrains.kotlin.android' // Add this if you're using Kotlin
  }
  

• For a standalone application module (if you replaced app with a new main module):

  plugins {
      id 'com.android.application'
      id 'org.jetbrains.kotlin.android'
  }
  

If the plugin is missing or incorrect, Gradle won’t treat the folder as a valid Android module.

3. Manually Add Dependencies (If Module Settings Still Fails) #

If the Module Settings window still doesn’t show your modules, skip the GUI and add dependencies directly to testModule3’s build.gradle (Module level):

dependencies {
    // Replace ':yourTargetModule' with the actual module name from settings.gradle
    implementation project(':yourTargetModule')
    
    // Add other dependencies (e.g., AndroidX, third-party libs) here
}

Click Sync Project with Gradle Files (the elephant icon in the toolbar) to apply changes.

4. Clear Caches to Fix Stale Data #

Sometimes Android Studio caches old module data, causing inconsistencies. Try these steps:

• Click File → Invalidate Caches... → Invalidate and Restart
• Delete the .gradle and .idea folders in your project’s root directory, then reopen Android Studio
• Run a clean build: Build → Clean Project followed by Build → Rebuild Project

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