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 方法时。
自定义设置的程度更高可以满足大部分中小型企业的建站需求，同时修正了上一版中发现的BUG，优化了核心的代码占用的服务器资源更少，执行速度比上一版更快 主要的特色功能如下： 1）特色的菜单设置功能，菜单设置分为顶部菜单和底部菜单，每一项都可以进行更名、选择是否隐 藏，排序等。 2）增加企业基本信息设置功能，输入的企业信息可以在网页底部的醒目位置看到。 3）增加了在线编辑功能，输入产品信息，企业介绍等栏
手动创建运行配置：
- 点击右上角运行配置下拉框 → Edit Configurations… → + → Application
-
Main class栏输入完整类名（如com.example.App），不要点“Search by name”依赖IDEA索引（有时失效） -
Use classpath of module必须选对模块（通常是your-project-name.main，不是your-project-name.test） - 若用
application插件，可改用 Gradle 类型运行配置，任务填run，这样直接走Gradle生命周期，环境更一致
Gradle构建成功但IDEA里仍有红色波浪线
典型表现：./gradlew build 通过，但IDEA编辑器里 import org.junit.jupiter.api.Test; 画红线，提示“Cannot resolve symbol”。这是IDEA的索引未同步Gradle解析出的依赖。
优先尝试：
- 右键项目根目录 → Reload project（注意不是“Reload dependencies”）
- 检查
Settings → Build → Build Tools → Gradle → Runner中 “Delegate IDE build/run actions to Gradle” 是否开启——开启后IDEA会调用Gradle执行编译，而非用自己的编译器，能彻底规避不一致 - 如果用了
implementation但想在测试中用，需确认testImplementation是否也声明了对应依赖；IDEA不会把 main 的 classpath 自动透传给 test
Gradle配置和IDEA行为之间存在多层映射，最容易被忽略的是：IDEA的“Project SDK”、“Module SDK”、“Gradle JVM”、“Gradle toolchain” 四者可以各自不同，出问题时得逐个核对，而不是只改一处。
