Android Studio提示package不存在但文件实际存在的解决方法求助

问题现象 #

Android Studio中频繁抛出"package does not exist"错误，但对应的文件实际存在，错误示例如下：

错误1 #

error: package com.blazecode.scrapguidev2.ui.Items.enums does not exist
import com.blazecode.scrapguidev2.ui.Items.enums.Modpack;
                                                ^

错误2 #

error: package com.blazecode.scrapguidev2.ui.Items.util does not exist
import com.blazecode.scrapguidev2.ui.Items.util.ModpackTypeConverter;
                                               ^

已尝试的操作：

• Clean Build
• Rebuild Project
• 清除缓存并重启（勾选全部选项）
• 删除.idea文件夹
• 删除build文件夹
• 删除app/build文件夹
• 重启计算机

使用版本信息：

• Kotlin: 1.7.10
• Gradle: 7.3.1
• Android Studio: Dolphin | 2021.3.1 Patch 1 Build #AI-213.7172.25.2113.9123335

额外解决步骤 #

1. 检查目录/包名大小写 #

Android Studio在类Unix系统（macOS/Linux）下对文件路径大小写敏感。确认代码中引用的包名（如ui.Items.enums）和实际文件系统中的目录名称大小写完全一致——比如实际目录是items全小写，但代码写了Items，就会触发找不到包的错误。

2. 标记目录为源码根 #

右键存放目标文件的父目录（如ui/Items所在的目录），选择Mark Directory as -> Sources Root。未被标记为源码根的目录不会被Gradle纳入编译范围，导致无法识别其中的类和包。

3. 检查Gradle源码路径配置 #

打开app/build.gradle文件，确认sourceSets中包含你的源码目录：

android {
    sourceSets {
        main {
            java.srcDirs = ['src/main/java', 'src/main/kotlin']
            // 若自定义目录不在默认路径，需手动添加
            // java.srcDirs += 'src/main/custom-src'
        }
    }
}

确保存放Modpack、ModpackTypeConverter的目录被包含在java.srcDirs或kotlin.srcDirs中。

4. 同步Gradle并重新构建 #

完成上述修改后，点击AS右上角的Sync Project with Gradle Files按钮，等待同步完成后执行Rebuild Project。

5. 检查模块依赖（若涉及子模块） #

如果目标文件属于子模块，确认主app模块已正确依赖该子模块。在app/build.gradle的dependencies块中检查是否存在：

dependencies {
    implementation project(':your-submodule-name')
}

6. 手动清除全局Gradle缓存 #

删除全局Gradle缓存目录，强制Gradle重新下载依赖并构建：

• Windows: C:\Users\<你的用户名>\.gradle\caches
• macOS/Linux: ~/.gradle/caches
  删除后重新打开项目，等待Gradle初始化完成。

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