新手装 JDK 必踩的 8 个坑：从下载到 hello world，我替你都踩过一遍
新手装 JDK 必踩的 8 个坑：从下载到 hello world，我替你都踩过一遍
写在前面：作为一个曾经把
java -version敲了二十遍还报"不是内部命令"的人，我太懂那种对着黑色命令行窗口抓耳挠腮的感觉了。这篇随笔不教你"怎么装"，只讲你装的时候一定会卡住的那些地方。
一、先说个概念：Java 和 JDK 到底是啥关系？
很多新手第一步就懵了——我到底是装 Java 还是装 JDK？
一句话讲清楚：
- Java 是一门编程语言；
- JDK（Java Development Kit）是写 Java 程序用的开发工具包；
- 你电脑上跑
.java文件、编译javac，靠的就是 JDK。
所以你只需要装 JDK，不用再单独装一个叫"Java"的东西。网上那些"安装 Java"的教程，本质上装的就是 JDK。
二、版本怎么选？别一上来就装最新版
这是第一个大坑。
打开 Oracle 官网，你会看到 JDK 8、11、17、21……还有什么 LTS、Oracle OpenJDK、Adoptium、Temurin、Zulu……
新手建议直接照下面选，别纠结：
| 场景 | 推荐版本 |
|---|---|
| 跟着学校教程 / 老视频学 | JDK 8（用的人最多，报错搜得到答案） |
| 学 Spring Boot 3.x / 新框架 | JDK 17 或 JDK 21 |
| 不想被 Oracle 商业授权追着跑 | OpenJDK / Temurin（Eclipse 出的，免费随便用） |
血泪教训：别装 JDK 9/10/12/13/14/15/16/18/19/20 这种非 LTS 版本，半年就过时，教程都找不到。
三、下载地址别瞎搜
直接给你能进的门：
- Adoptium Temurin（推荐，免费无版权问题）：https://adoptium.net/
- Oracle JDK（要注册账号，个人学习也行）：https://www.oracle.com/java/technologies/downloads/
下载 Windows 版认准这个图标：
.exe：傻瓜式安装包，一路下一步.zip：解压即用，不写注册表，适合多版本切换
新手直接下 .exe，别给自己加戏。
四、安装路径：千万别带中文、别带空格
这是第二个高频坑。
安装的时候，默认路径通常是：
C:\Program Files\Java\jdk-1.8\
Program Files 中间那个空格，在某些老旧工具 / 脚本里会让你怀疑人生。
建议改成：
D:\dev\jdk1.8
记住三个原则：
- 全英文
- 无空格
- 路径别太深（别放桌面、别放"下载"文件夹里）
我见过有人装在 C:\用户\张三\桌面\软件\新建文件夹\Java\，最后 IDEA 直接找不到主类。
五、环境变量：90% 的人都死在这一步
装完之后，打开命令提示符（Win+R 输入 cmd），敲：
java -version
如果出现"'java' 不是内部或外部命令，也不是可运行的程序或批处理文件"——恭喜，这就是你要看这篇文章的原因。
5.1 需要配哪几个变量？
右键"此电脑" → 属性 → 高级系统设置 → 环境变量。
在系统变量里新建：
变量名： JAVA_HOME
变量值： D:\dev\jdk1.8（就是你刚才的安装目录，到 jdk 这一层就停，别带 bin）
然后找到系统变量里的 Path，双击编辑，新增一行：
%JAVA_HOME%\bin
⚠️ 老版本 Windows 是一整行用分号隔开的，千万别把原来的内容删了！在最前面或最后面加分号再粘进去就行。
5.2 CLASSPATH 还要不要配？
JDK 1.5 以后完全不用配 CLASSPATH，网上那些老教程让你写什么 .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar 的，直接忽略。配了反而可能出问题。
5.3 配完必须做这件事
关掉所有已经打开的 cmd 窗口，重新开一个！
环境变量改完，老窗口是不会生效的，这是新手第二大迷惑行为——改了十遍，敲出来还是报错。
然后验证：
java -version
javac -version
两条命令都能打印出版本号，才算真正装好。
六、常见报错对照表
| 报错信息 | 原因 | 解决办法 |
|---|---|---|
'java' 不是内部或外部命令 |
Path 没配 / 配错了 / cmd 没重启 | 检查 %JAVA_HOME%\bin 是否加进 Path，重开 cmd |
javac 不是内部或外部命令 |
只配了 JRE，没配 JDK；或 Path 指向了 jre\bin | 确认 JAVA_HOME 指向的是 jdk 目录，不是 jre |
java 版本文艺复兴：java -version 和 javac -version 对不上 |
系统里装了多个 JDK，Path 里顺序乱了 | 把自己配的 %JAVA_HOME%\bin 上移到最上面，卸载多余版本 |
错误: 找不到或无法加载主类 |
路径有中文 / 空格，或者编译运行目录不对 | 换到纯英文路径，cd 到 .java 文件所在目录再执行 |
| IDEA 里提示 "Project SDK is not defined" | IDE 不知道你 JDK 装哪了 | File → Project Structure → SDKs → 加号 → 选你的 JDK 目录 |
七、macOS 用户额外提一句
macOS 装 JDK 最省心的方式是用 Homebrew：
brew install openjdk@17
装完之后按它终端里打印出来的提示，做个软链接就行。别去官网 dmg 一路下一步，装完你都不知道文件藏哪了。
八、装完第一件事：写个 hello world 验证一下
别光看版本号就觉得万事大吉了。新建一个文件夹，写个 Hello.java：
public class Hello {
public static void main(String[] args) {
System.out.println("Hello, JDK! 我终于装上了。");
}
}
注意：
- 文件名必须叫
Hello.java，和public class后面的名字一模一样，大小写敏感 - 在当前目录打开 cmd，执行：
javac Hello.java
java Hello
看到打印出 Hello, JDK! 我终于装上了。，恭喜你，这关就算过了。
写在最后
装 JDK 这件事，看起来是"下一步下一步"的事，但对新手来说，报错信息一个字都看不懂才是常态。
我的建议是：
- 版本选 JDK 8 或 17，别追新；
- 路径纯英文无空格；
- 环境变量只配
JAVA_HOME和Path，别碰 CLASSPATH； - 改完一定重开 cmd；
- 跑通 hello world 再往下学。
希望这篇随笔能帮你少熬两个晚上。有问题评论区见。
本文同步发布于博客园，转载请注明出处。
浙公网安备 33010602011771号