装对版本、路径干净、环境变量配准三步到位：选jdk 17/21（新手/lts）或jdk 8（老系统/面试），避免非lts；安装路径全英文无空格；仅配java_home和path，勿设classpath；验证需java -version与javac -version均成功。

装对版本、路径干净、环境变量配准，三步到位基本就不会出错。

选对版本，别被“最新”带偏

新手最容易卡在第一步：下错了包。不是所有“JDK”都适合你。

• 刚学 Java 或启动新项目：直接装 JDK 17 或 JDK 21（当前主流 LTS 版本，免费、稳定、工具链成熟）
• 要跑公司老系统或面试刷题：查清楚项目要求，大概率是 JDK 8，别硬上 21，否则编译报错、反射失败、Lombok 不生效都是常见问题
• 别碰非 LTS 版本（比如 JDK 22、23），它们支持周期短、IDE 和框架适配可能滞后

安装路径必须“干净”

Windows 默认装到 C:\Program Files\Java\ 看似省事，但空格会让部分脚本、旧版构建工具（如 Ant、某些 Maven 插件）解析失败，报错像“找不到文件”“路径语法错误”。

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

• 推荐路径示例：D:\jdk-21、C:\dev\jdk-17——全英文、无空格、无括号、无中文
• Mac 用户注意芯片类型：Intel 选 x64，M1/M2/M3 选 arm64，下错包装完也运行不了
• 安装时勾选全部默认组件（开发工具、源码、JRE），新版 JDK 已不单独分发 JRE，不用额外装

环境变量只配两个关键项

网上教程常让配 CLASSPATH，现在完全不需要——它早已过时，配了反而干扰类加载，删掉更安全。

• JAVA_HOME：值填 JDK 安装根目录，例如 D:\jdk-21（不要带 \bin）
• Path：新增一项，填 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux）
• 改完后必须新开命令行窗口验证，旧窗口不会自动刷新环境变量

验证必须用两行命令，缺一不可

只敲 java -version 成功，不代表能开发；必须同时通过下面两个检查：

• java -version → 显示版本号，说明运行环境就位
• javac -version → 显示相同版本号，说明编译器可用，JDK 装全了
• 如果 javac 报“不是内部或外部命令”，90% 是 Path 没指向 bin 目录，或 JAVA_HOME 路径写错了

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南