idea打开java源码需先确认是否为标准maven/gradle项目，否则仅作普通文件夹处理；无构建文件时可手动创建module或补最简pom.xml/gradle配置以支持依赖解析与代码功能。
IDEA 打开 Java 源码前先确认是不是标准 Maven/Gradle 项目
很多 Java 源码仓库（比如 GitHub 上的开源库）看着是 src/main/java 目录结构，但没 pom.xml 或 build.gradle，就不是工程化项目——IDEA 导入后只会当普通文件夹，没有依赖解析、代码跳转、自动补全。
实操建议：
- 进根目录看有没有
pom.xml（Maven）或build.gradle（Gradle），没有就别点 “Open Project”，改用 “File → Open” 并选中该文件 - 如果只有
.iml文件，说明之前有人用 IDEA 生成过模块配置，可以试试直接打开它，但注意：.iml不跨环境，换人/换版本容易失效 - 遇到
src下有java和resources但无构建文件的，手动创建最简pom.xml再导入，比硬拖进 IDEA 更可靠
导入 Maven 项目时 Dependencies 不加载或报红怎么办
常见现象是：项目结构显示正常，但所有 import 全标红，Maven Projects 工具窗里 dependency 树为空，或者提示 Cannot resolve symbol 'xxx'。
原因往往不是网络或镜像问题，而是 IDEA 没触发 Maven 解析流程：
立即学习“Java免费学习笔记（深入）”；
- 检查右下角是否弹出 “Import changes?” 提示，点了 “Enable Auto-Import” 就能自动响应
pom.xml变更；没弹出就手动点Maven Projects窗口右上角的刷新按钮 - 确认 IDEA 使用的 Maven 是你本地装的那个，不是内置的 bundled 版本：进入
Settings → Build → Build Tools → Maven，把Maven home path改成你mvn -v输出的实际路径 - 某些老项目用 JDK 8 编译但 IDEA 默认用 JDK 17，会导致
sourceCompatibility冲突，表现为依赖能下载但类不识别——在Project Structure → Project里统一设好 SDK 和 language level
Gradle 项目导入后 gradle.properties 或 settings.gradle 被忽略
典型表现是：模块没列出来、buildSrc 不生效、自定义仓库地址没起作用，甚至整个项目变成空的灰色文件夹。
Gradle 的初始化比 Maven 更依赖上下文：
- 不要用 “Open” 打开
build.gradle文件本身，必须打开包含settings.gradle（或settings.gradle.kts）的根目录 - 如果项目用了
gradle.properties配置org.gradle.jvmargs或仓库地址，确保该文件在项目根目录，且 IDEA 的 Gradle 设置里勾选了 “Use default gradle wrapper (recommended)” - 遇到
Could not determine java version from '17.0.1'这类错误，不是 Java 版本太高，而是 Gradle 版本太低——查gradle/wrapper/gradle-wrapper.properties里的distributionUrl，升级到兼容 JDK 17+ 的 Gradle 7.3+
源码没 pom.xml 也没 build.gradle？手动配 Module 最快
比如 JDK 源码、Android AOSP 模块、或某个只含 .java 文件的老 demo，这时强塞 Maven/Gradle 反而添乱。
直接告诉 IDEA：“这就是一堆 Java 文件，按 JDK X 编译”：
- 菜单选
File → Project Structure → Modules → + → New Module → Java，指定src路径，SDK 选对即可 - 如果源码带测试代码，手动在
Modules里把src/test/java标为 Tests，否则@Test注解不识别 - 注意：这种纯 Java Module 不支持依赖管理，
lib/xxx.jar得手动加到Libraries里，且每次换机器都要重配
真要长期看源码，还是建议补个最简 pom.xml：三行声明 groupId/artifactId/version，再加个 maven-compiler-plugin 设定 source/target，后续维护成本低得多。
