关键在安装路径和环境变量两处盯紧细节:下载时避开中文、空格路径,安装目录须为纯英文无特殊符号(如D:\Java\jdk-17);JAVA_HOME必须指向JDK根目录(不含bin),Path中添加%JAVA_HOME%\bin并置顶,最后重启终端和IDE验证。

关键在安装路径和环境变量两处盯紧细节,路径报错90%出在这两个环节。
你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在
下载时就避开中文和空格路径
安装包别存在“我的文档”“桌面”或任何含中文、空格、特殊符号的文件夹里。推荐直接建一个简洁目录,比如:
D:\Java\jdk-17
下载链接务必来自官方源(Oracle 或 Eclipse Temurin),不点来路不明的网盘或第三方镜像——那些常偷偷改默认安装路径到C:\Program Files (x86)\某广告软件下,一装就埋雷。
安装时手动指定顶层目录,不接受默认
运行.exe后,在“选择安装位置”这一步必须点开并修改路径,填入你提前准备好的纯英文无空格路径(如D:\Java\jdk-17)。记下这个完整路径,后面全靠它。
注意:不要勾选“同时安装JRE”,JDK 17 自带 JRE,多装反而容易冲突。
JAVA_HOME 必须指向 JDK 根目录,不是 bin 子目录
配置系统变量时:
• 变量名写 JAVA_HOME(大小写敏感)
• 变量值填你记下的完整路径,结尾不加反斜杠,也不包含 bin,例如:
✅ 正确:D:\Java\jdk-17
❌ 错误:D:\Java\jdk-17\bin 或 D:\Java\jdk-17\
如果填错,java 命令可能勉强能跑,但 javac 会直接报 “tools.jar not found”,Maven 编译也会失败。
Path 中添加 %JAVA_HOME%\bin 并置顶
在系统变量 Path 里新增一项:
%JAVA_HOME%\bin
然后把它拖到 Path 列表最上方。这样能确保系统优先调用你刚装的 JDK 17,而不是残留的旧版本(比如 C:\Windows\System32 下的旧 java.exe)。
改完后,关掉所有已打开的命令行窗口,再新开一个 cmd 验证:
- 输入 echo %JAVA_HOME% → 应显示你设的路径
- 输入 where java → 应只返回一行,且路径含 jdk-17
- 输入 java -version 和 javac -version → 两者版本号必须完全一致
验证通过后别忘了重启终端和IDE
即使环境变量配对了,已打开的 IntelliJ、VS Code 或 Android Studio 仍可能缓存旧路径。关掉所有开发工具,重新启动,再进设置里手动指定 JDK 路径为 %JAVA_HOME% 对应的目录,避免“命令行能用,IDE 找不到 JDK”的经典问题。

















