优先选JDK 17——存量项目兼容性更好，Spring Boot 2.7.x等主流框架广泛支持；新项目若明确使用Spring Boot 3.2+等新版生态，可选JDK 21。
Java版本选哪个：JDK 17还是JDK 21？
Java本地开发环境稳定性的第一道门槛，是JDK版本选择。JDK 17（LTS）和JDK 21（LTS）目前都具备长期支持，但实际项目中JDK 17更稳妥——多数主流框架（Spring Boot 3.0+才完全适配JDK 21的虚拟线程等特性），而Spring Boot 2.7.x仍广泛用于存量项目，它在JDK 21下可能触发UnsupportedClassVersionError或IncompatibleClassChangeError。
建议按以下条件决策：
- 新项目且明确使用Spring Boot 3.2+、Micrometer 1.12+等新版生态 → 选
jdk-21.0.3（推荐Adoptium Temurin构建） - 维护老系统、对接遗留中间件（如WebLogic 14c、IBM JDK兼容组件）→ 锁定
jdk-17.0.8 - 避免用Oracle JDK商业版（自JDK 17起需付费商用），改用
temurin-17.0.8_7-jdk或zulu-21.32.17-ca-jdk - 别混用不同厂商JDK（例如IntelliJ用Temurin，Maven用Zulu），会导致
javac与java行为不一致
PATH和JAVA_HOME怎么设才不冲突？
Windows/macOS/Linux上最常踩的坑不是装错JDK，而是环境变量污染。典型现象：终端里java -version显示JDK 21，但IDE报错“Module not found: java.base”，或Maven编译提示source release 21 requires target release 21——本质是JAVA_HOME没对齐，或PATH里残留旧JDK路径。
正确做法：
立即学习“Java免费学习笔记（深入）”；
-
JAVA_HOME必须指向JDK根目录（不是jre/子目录），例如/Library/Java/JavaVirtualMachines/temurin-17.0.8+7/Contents/Home（macOS） -
PATH中只保留$JAVA_HOME/bin，删掉任何绝对路径如/usr/bin/java或C:\Program Files\Java\jdk1.8.0_202\bin - Shell配置文件（
~/.zshrc或~/.bash_profile）里用export JAVA_HOME=...，别用set JAVA_HOME=...（后者是Windows cmd语法） - IDE（IntelliJ/Eclipse）需单独配置SDK，不继承系统
JAVA_HOME；Maven则依赖mvn -v输出中的Java版本，而非IDE设置
Maven本地仓库卡住或校验失败怎么办？
本地开发环境“不稳定”的高频诱因是Maven依赖拉取异常：下载中断、SHA256 checksum failed、Could not transfer artifact。这通常不是网络问题，而是本地仓库元数据损坏或镜像源配置失效。
快速修复步骤：
- 确认
~/.m2/settings.xml中<mirror>指向可用镜像（国内推荐https://maven.aliyun.com/repository/public，别用已停服的http://maven.oschina.net） - 删除出错模块的本地缓存目录，例如
rm -rf ~/.m2/repository/org/springframework/boot/spring-boot-starter-web，再重跑mvn clean compile - 禁用校验（仅临时调试）：
mvn compile -Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true - 避免手动修改
~/.m2/repository下的_remote.repositories或maven-metadata-central.xml——这些文件由Maven自动维护，手改必乱
IntelliJ里模块编码和编译输出路径为何总出错？
即使JDK和Maven都正常，IntelliJ仍可能编译失败，错误如Cannot resolve symbol 'List'或Output path is not specified。根源在于项目级与模块级配置未对齐。
关键检查点：
- File → Project Structure → Project：确认
Project SDK和Project language level匹配（例如SDK选17，language level不能设为8） - File → Project Structure → Modules → Sources tab：确保
src/main/java标记为Sources，且src/test/java标记为Test Sources；否则类不会被编译器识别 - File → Settings → Build → Compiler → Java Compiler：勾选
Use compiler from module target bytecode version，否则可能生成JDK 8字节码却用JDK 17运行 - Build → Build Artifacts → Output directory若为空，会直接导致
ClassNotFoundException，需手动指定为$PROJECT_DIR$/out/artifacts
环境稳定的核心不在“装得多”，而在“对得准”——JDK版本、环境变量、仓库配置、IDE参数，四者必须形成闭环。任何一个环节用默认值硬扛，后面都会在CI构建或同事协作时暴露出来。
