Gradle项目导入IDEA后源码目录未识别，需右键src/main/java设为Sources Root或刷新Gradle配置；Java版本需同步配置Gradle JVM与IDEA SDK；依赖红标应重载项目并开启Delegate构建；运行配置须手动指定主类或使用Gradle run任务。
Gradle项目导入后IDEA没识别出Java源码目录
常见现象是 src/main/java 下的类不被当作源根（Sources Root），代码无语法高亮、无法跳转、编译报 package does not exist。这通常不是Gradle配置问题，而是IDEA未正确应用Gradle元数据。
解决方法：右键点击 src/main/java → Mark Directory as → Sources Root；但更可靠的做法是触发Gradle重载——点击右侧 Gradle 工具窗 → 点击刷新按钮（或执行 ./gradlew --refresh-dependencies 后再刷新项目）。确保 build.gradle 中已声明 apply plugin: 'java' 或使用 java DSL（Gradle 7+）。
- 检查
build.gradle是否含sourceSets.main.java.srcDirs = ['src/main/java']这类手动覆盖，它可能和IDEA默认约定冲突 - 若用 Kotlin DSL（
build.gradle.kts），确认java { /* ... */ }块存在且未禁用 - IDEA 2022.3+ 默认启用 “Use Gradle configuration for project structure”，可在
Settings → Build → Build Tools → Gradle中确认是否勾选
IDEA里修改了Java版本但Gradle编译仍报错
比如你在 Project Structure → Project 设为 JDK 17，但执行 gradle build 时提示 error: invalid source release: 17，说明Gradle本身没读取到该设置——IDEA的项目JDK和Gradle JVM是两个独立配置。
必须显式指定Gradle使用的Java版本：
立即学习“Java免费学习笔记（深入）”；
- 在
gradle.properties中添加：org.gradle.java.home=/path/to/jdk-17（macOS/Linux 路径如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home，Windows 如C:\\Program Files\\Java\\jdk-17） - 或在
build.gradle中设置：java.toolchain.version = "17"（Gradle 6.7+ 推荐方式，比sourceCompatibility更准确） - 避免只设
sourceCompatibility = JavaVersion.VERSION_17，它不控制编译器JVM，仅影响字节码目标版本
运行/调试时提示 NoClassDefFoundError 或找不到 main 方法
这不是classpath缺失就是启动类配置错误。Gradle项目中，IDEA默认不会自动识别 main 类，尤其当入口类不在默认包或有多个 main 方法时。
