Win10下JDK8安装与环境变量配置全流程

装 JDK8 这件事，说简单是真简单，双击安装包一路下一步，十分钟搞定；说麻烦也是真麻烦，我见过太多人卡在环境变量那一步，命令行敲java -version弹出一句"不是内部或外部命令"，然后整个人就懵了。Win10 这一代系统在环境变量界面上做了不少改动，Path 变成了列表式编辑，看似更友好，实际上把很多人熟悉的那套"复制一长串分号路径"的操作习惯给打断了。所以这篇东西我打算把 Win10 下 JDK8 安装与环境变量的配置整个流程拆到不能再细，包括每一个勾选项、每一段变量值、每一种报错怎么定位。

先明确一下这篇文章解决什么问题：你要在一台 Windows 10 机器上装上 JDK8（也就是 JDK 1.8，业内说 jdk8 和 jdk1.8 是同一个东西），并且让命令行和 IDE 都能正常用起来。适合谁看？刚入门 Java 的同学、需要跑老项目的开发者、要在本机搭一套测试环境的运维、以及那些装过一次但没搞明白为什么这么配的人。哪怕你之前只会点"下一步"，照着走也能配通；如果你已经会装，中间那些"为什么这么填"的段落应该能帮你把以前抄来的东西真正理解掉。

1. 装 JDK8 之前需要想清楚的三件事

动手之前先花五分钟想明白这三件事，能省掉后面至少一个小时的返工。我在带新人的时候发现，绝大多数环境问题的根子不在配置那一步，而是在安装之前就没规划好：装哪儿、从哪儿下、本机上有没有残留的旧版本。

1.1 JDK8 为什么到现在还被人反复安装

按理说 Java 都更新到二十几个版本了，为什么还在装 8？原因很现实。一是大量存量项目——尤其是一些企业内部的中间件、老框架、老构建脚本——对 JDK8 之后的语言级变化不兼容，比如模块化系统带来的反射限制、移除的sun.misc.*内部 API、JAXB 从标准库剥离等等，升版本就是一场重构。二是 JDK8 是最后一个 LTS 且"事实标准"最稳的版本，很多工具链的默认兼容基线就是它。三是 JDK8 引入了 Lambda 表达式、Stream API、新的日期时间 API（java.time）、Optional、接口默认方法这些东西，直到今天仍然是写业务代码的主力语法，面试也爱问。

正因为 JDK8 的"生命周期"被拉得特别长，新机器上装 8 几乎成了一个保留动作。你要清楚一点：JDK8 有两个发布系列，Oracle JDK 8和OpenJDK 8。Oracle 从 8u211 之后就改成商业许可了，如果你只是本地学习、跑跑 demo 没问题，但公司正式环境用哪个，最好问一下团队规范。OpenJDK 8 的常见发行版有 Eclipse Temurin（原 AdoptOpenJDK）、Amazon Corretto、Azul Zulu 等，都是免费可商用的，功能上跟 Oracle JDK 8 基本一致，只在少数加密套件和字体库上有差异。

实操心得：如果你所在的项目没有强制要求"必须是 Oracle JDK"，选 OpenJDK 8 的发行版会更省心，安装包更干净，没有捆绑的额外组件，也不需要去注册账号才能下归档版本。

1.2 下载渠道的取舍：官网归档、发行版站点、镜像站

下载这一环，最容易出问题的地方是"下到了带一堆捆绑软件的安装包"。搜索"jdk8 下载"出来的结果里，前几页经常混着某些软件站重新打包的版本，装完附带浏览器主页修改、全家桶弹窗，非常恶心。

三个稳妥的渠道，按推荐度排：

1. OpenJDK 发行版官方站点：Eclipse Temurin 的官网、Amazon Corretto 的下载页，直接提供.msi或.zip，.msi好处是能自动写一部分注册表信息，.zip好处是纯绿色解压即用。
2. 国内高校与云厂商的开源镜像站：下载速度比海外站点快得多，适合网络环境一般的情况。注意镜像站要选有明确维护方的，别去那种个人搭的临时站。
3. Oracle 官方归档页：老版本 JDK8 的归档页面还在，但下载需要登录账号，流程烦一点。

注意事项：不管从哪儿下，下完先核对两件事——文件大小是否和官方标注一致，以及安装包的数字签名。Windows 上右键安装包 → 属性 → 数字签名，能看到签发者信息是正常的；如果这个标签页是空的，直接删掉重下，别装。

1.3 动手前先给系统做三项清理

第一项，卸载残留的旧 JDK 或 JRE。控制面板 → 程序和功能，把所有带 "Java" 的条目看一遍，确认是不是还有 jdk1.7、jre1.8 之类的东西。多个版本共存不是不行，但如果你只是想装一个干净的 8，先卸掉能少一堆麻烦。卸载后建议手动检查一下C:\Program Files\Java和C:\Program Files (x86)\Java这两个目录，有时卸载程序会留下空文件夹或者残留的jre目录。

第二项，临时关掉安全软件的实时防护。部分杀毒软件对安装程序写入注册表和环境变量的行为比较敏感，会拦截或者延迟放行，导致安装"看起来完成了"但实际有文件没落盘。装完以后再打开就行，别嫌麻烦。

第三项，确认磁盘空间和权限。JDK8 完整安装大概占 300 到 500 MB，不是什么大问题，但你要确保安装目标盘有空间。更重要的是权限——如果你打算装到C:\Program Files下面，安装程序会触发 UAC 提权弹窗，一定要点"是"，否则会出现部分文件写入失败。

提示：不要用中文用户名对应的路径去装。如果你的 Windows 账户名是中文，某些安装程序解压临时文件时会在用户临时目录出问题，遇到莫名其妙的安装中断，先换个英文名的管理员账户试试。

2. Win10 下 JDK8 安装过程逐步拆解

准备工作做完，正式进安装。这一段我把每个界面会看到什么、该点哪个按钮都写清楚。安装 JDK8 的过程中真正需要你动脑子的地方只有两处：组件勾选和安装路径。

2.1 安装向导里那两个勾选项到底要不要勾

双击安装包，前面两步是欢迎界面和安装路径选择。到了"自定义安装"界面，你会看到两个可以展开的树形节点：开发工具（Development Tools）和源代码（Source Code），然后下面还有一个独立的公共 JRE（Public JRE）选项。

逐个说：

• 开发工具：这是 JDK 的核心，包含bin目录下的javac.exe、java.exe、jar.exe、jdb.exe等，以及lib目录下的类库。必须装，不能取消。取消了你这台机器上就只有运行环境没有编译能力。
• 源代码：指的是src.zip，JDK 标准库的源码压缩包。它不参与编译和运行，但如果你用 IDE 看源码、点进ArrayList想看实现，就需要它。建议勾上，占不了多少空间（大约 20 到 30 MB），以后debug 的时候能省一次重装。
• 公共 JRE：这是给不使用 JDK 的普通用户准备的独立运行环境，会往系统里额外注册一份 JRE。现代开发场景下基本用不上，因为 JDK 目录里自带的jre子目录已经够 IDE 和工具用了。建议取消勾选，少一份东西就少一个排查变量。

这里有个细节：JDK8 的安装目录结构里，jdk1.8.0_xxx下面会有一个jre子目录，这个jre里面有它自己的bin，里面只有一个java.exe，没有javac.exe。这就是后面很多人"能运行不能编译"的根本原因，我们先记住这个结构。

2.2 安装路径放 C 盘还是 D 盘的取舍

默认路径是C:\Program Files\Java\jdk1.8.0_xxx。我不建议直接用默认路径，理由有两个。

第一，Program Files里有空格。绝大多数现代工具处理带空格的路径没问题，但一些老旧脚本、Makefile、批处理、某些开源构建工具在拼接路径时没有加引号，遇到空格就会把路径切断，报出莫名其妙的"找不到文件"。这是老生常谈但确实还在发生的事。

第二，Program Files有权限保护。你想往里面手动放点补丁 jar、临时改个配置文件，都要管理员权限，很烦。

我的做法是建一个专门放开发工具的目录，比如C:\Dev\Java\或者D:\Develop\Java\，把 JDK 装在里面：

C:\Dev\Java\jdk1.8.0_202

这样路径短、没有空格、没有权限问题，环境变量写起来也清爽。如果你的 C 盘是固态而 D 盘是机械盘，那还是装 C 盘，编译和 IDE 索引速度差别很明显。

安装路径在向导里可以直接改。注意一个常见的坑：很多人改的是安装路径，但接下来还有一步"选择 JRE 安装目标文件夹"，如果前面勾了公共 JRE，这里会再要求一个路径。所以我干脆前面就取消公共 JRE，少一步。

2.3 安装完成后的三种验证方式

装完之后先别急着配环境变量，这时候命令行还认不到java，是正常的。我们可以先直接进安装目录验证文件完整性。

方式一：看文件结构。打开C:\Dev\Java\jdk1.8.0_202，确认这几个东西都存在：

方式二：在安装目录里开命令行测试。按住 Shift 键在bin目录空白处右键，选择"在此处打开 PowerShell 窗口"（或者直接在资源管理器地址栏输入cmd回车）。然后输入：

javac -version

如果输出javac 1.8.0_202，说明二进制文件是好的，问题只可能在环境变量上。这一步很关键，它把"文件问题"和"配置问题"分开了，能帮你少走很多弯路。

方式三：检查注册表里有没有留下痕迹。运行regedit，看HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft下面是否有Java Development Kit项。有的话说明安装程序正常写入了注册信息，一些依赖注册表找 JDK 的软件（比如旧版 Eclipse、部分 Installer）能自动识别。

注意：如果方式一里发现bin目录是空的，或者jre目录缺失，不要试图手动补文件，直接卸载重装，大概率是杀软拦截或者解压中断导致的。

3. 环境变量配置：三个变量各管什么、怎么填

这是全文的核心，也是翻车率最高的地方。我先把三个变量的逻辑讲清楚，再给具体的操作步骤。理解了逻辑，你以后换机器、换版本都不用再查教程。

3.1 JAVA_HOME、Path、CLASSPATH 的分工

打个比方。JAVA_HOME相当于你给系统留的"JDK 家庭住址"，它本身不会让任何命令生效，纯粹是一个被引用的变量。Path相当于"系统能敲开哪些门"，你把它放进 Path，系统才允许你在任意目录下直接敲java。CLASSPATH相当于"运行时去哪儿找类文件"，Java 虚拟机启动时按它的指示加载.class。

三者的关系是层层引用：

JAVA_HOME = C:\Dev\Java\jdk1.8.0_202 Path = ...;%JAVA_HOME%\bin CLASSPATH = .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

%JAVA_HOME%这种写法叫变量引用，Windows 在执行时会把它展开成实际路径。用变量的好处是：以后你要换成jdk1.8.0_301，只要改JAVA_HOME一个地方，Path 和 CLASSPATH 自动跟着变。如果你在 Path 里直接写死C:\Dev\Java\jdk1.8.0_202\bin，那换版本就得改三处，很容易漏。

为什么强烈建议配JAVA_HOME：Maven、Gradle、Tomcat、Hadoop、Kafka，一长串工具在启动脚本里都会去读JAVA_HOME。你不配这个变量，这些工具会报 "JAVA_HOME is not defined correctly"。所以哪怕只是为了自己省事，也要配。

3.2 Win10 图形界面配置全流程

Win10 打开环境变量设置的路径有好几条，最快的是这个：

按Win + R，输入sysdm.cpl回车，打开"系统属性"窗口 → 切到"高级"选项卡 → 点右下角"环境变量"按钮。这条路比在桌面右键"此电脑"再点一堆要快。

打开后你会看到上下两个区域：

• 上半部分：用户变量，只对当前登录账户生效，不需要管理员权限。
• 下半部分：系统变量，对所有账户生效，修改需要管理员权限。

我个人的选择是：JAVA_HOME 建在系统变量里，Path 也改系统变量。理由是这样切换账户或者用其他身份运行程序时不会有差异。如果你在公司电脑上没有管理员权限，那就只能建在用户变量里，也能用，只是要注意后面可能出现的路径优先级问题。

第一步，新建 JAVA_HOME。在系统变量区域点"新建"，变量名填JAVA_HOME，变量值填你的实际安装目录，注意不要带\bin，不要以反斜杠结尾：

C:\Dev\Java\jdk1.8.0_202

这是最常见的错误之一——很多人写成C:\Dev\Java\jdk1.8.0_202\bin，然后 Path 里又拼一次%JAVA_HOME%\bin，最终变成...\bin\bin，当然找不到命令。

第二步，编辑 Path。选中系统变量里的Path，点"编辑"。Win10 这里会给一个分行的列表界面，每行一个路径。点右侧"新建"，粘贴：

%JAVA_HOME%\bin

关于要不要再新加一行%JAVA_HOME%\jre\bin：加不加都能跑，因为jdk\bin里已经有java.exe了。加上去的好处是万一某个工具硬要去找jre\bin，不至于找不到。我一般会加上，但顺序放在%JAVA_HOME%\bin的下面。

第三步（可选），新建 CLASSPATH。这个留到下一节细说。

第四步，一路确定。环境变量窗口点两次"确定"关掉，注意别点"取消"，很多人改完随手点了取消，白干。

3.3 CLASSPATH 到底还有没有必要配

这个问题有争议，我给一个明确的实用建议：配，但要配对。

现在的 Java 应用基本都是靠 IDE 或者 Maven/Gradle 管理依赖，运行时由-cp参数或者 Class-Path 清单指定类路径，系统级 CLASSPATH 用得很少。而且从 JDK6 开始，如果你完全不配 CLASSPATH，默认值就是.（当前目录），一般够用。

但是，很多老教程、老脚本、老项目会默认机器上有一个全局 CLASSPATH，尤其是需要直接用java命令跑单个 class、或者用 JDBC 连数据库跑测试的时候。所以配上不亏，配法如下：

新建系统变量CLASSPATH，值为：

.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

三个细节必须注意：

1. 最前面那个点不能丢。点代表"当前目录"，丢了以后你编译出来的 class 在同目录下都跑不起来，会报错误: 找不到或无法加载主类。这是新手最经典的坑，我至少帮人排查过二十次。
2. 用分号分隔，用反斜杠。别写成冒号，那是 Linux 的写法。
3. tools.jar只在 JDK 里存在，JRE 里没有。如果你把 CLASSPATH 指向了一个 JRE 目录，这一项就失效了，虽然通常不影响运行，但某些依赖编译 API 的工具会报错。

3.4 Path 变量被改坏了怎么救回来

这个必须单独讲，因为它是"事故级"操作。Path 变量是系统里所有命令行程序的搜索路径，里面装着C:\Windows\system32、C:\Windows、C:\Windows\System32\Wbem等等一堆关键目录。如果你在编辑的时候不小心把它们覆盖掉了，后果是cmd、ping、ipconfig这些命令全部失效，甚至部分软件启动不了。

两种编辑模式的差别：Win10 的 Path 编辑界面有一个"编辑文本"按钮，点了会把你带到一个长文本框里，所有路径用分号连在一起。很多人习惯在这个文本框里全选、粘贴自己的路径，结果把原有内容全删了。这就是事故高发点。

我的建议：

• 优先用列表模式（一行一个路径），点"新建"追加，不要去动已有的行。
• 如果非要进文本模式，先把整个文本框的内容复制出来，另存到记事本或者桌面文件里备份，改完对照一下有没有丢东西。
• 万一真删了，也不用重装系统。默认的最小集合大致是这几条（64 位系统）：

C:\Windows\system32 C:\Windows C:\Windows\System32\Wbem C:\Windows\System32\WindowsPowerShell\v1.0\ C:\Windows\System32\OpenSSH\

把这些补回去，重启终端基本就恢复正常了。但有些第三方软件（比如各种数据库、开发工具）自己加的路径会丢，需要你重新装一遍或者手动补。

提示：改 Path 之前先执行echo %PATH% > path_backup.txt，把当前 Path 导出到文件里。这条命令在哪个目录执行都行，文件会生成在当前目录下。养成这个习惯，你会感谢自己的。

4. 配置失败排查实录：从报错到定位

环境变量配完之后，实战就开始了。这一节我把这些年遇到过的典型报错按"症状 → 原因 → 处理"的方式整理出来，你可以当速查表用。

4.1 高频报错速查表

这张表覆盖了我遇到过的八成问题。下面挑几个最容易搞混的展开说。

4.2java不是内部或外部命令：五步定位法

这个报错本身没有任何信息量，它只说明"系统在 Path 列出的所有目录里都没找到java.exe"。所以排查思路就是把"Path 有没有这一条"和"这一条指向的目录里到底有没有 java.exe"这两件事分开验证。

第一步，确认变量真的存进去了。新开一个 cmd（一定要新开，旧窗口读的是旧环境变量），执行：

echo %JAVA_HOME%

如果输出的是%JAVA_HOME%本身，说明变量没定义成功，回去检查是不是建错了区域（用户变量和系统变量是两套），或者变量名多了空格。

第二步，确认 Path 里能看到这一条：

echo %PATH%

输出会很长，在里面找有没有C:\Dev\Java\jdk1.8.0_202\bin或者展开了的%JAVA_HOME%\bin对应的实际路径。找不到就说明 Path 没加成功。

第三步，用 where 确认系统到底找到了什么。这是我最常用的命令：

where java

Windows 的where相当于 Linux 的which，它会列出 Path 中所有匹配到的java.exe。如果输出为空，说明确实一条都没有；如果输出了多个路径，第一个就是实际生效的那个。

第四步，直接验证目录里有没有文件：

dir C:\Dev\Java\jdk1.8.0_202\bin\java.exe

如果提示找不到文件，那问题不在环境变量，而在于安装本身有问题。

第五步，确认没有路径拼写问题。看JAVA_HOME的值末尾有没有多余的反斜杠或者空格。C:\Dev\Java\jdk1.8.0_202后面多一个空格，展开后就变成C:\Dev\Java\jdk1.8.0_202 \bin，找得到才怪。

4.3 版本对不上：多 JDK 共存导致的串台

症状是：你明明配置的是 JDK8，但java -version出来是 17 或者 21。原因通常是机器上装了多个 JDK，而在 Path 中排在前面的那个优先级更高。

排查方法还是where java，它会一次性把命中的路径全列出来：

where java

假设输出是：

C:\Program Files\Common Files\Oracle\Java\javapath\java.exe C:\Dev\Java\jdk1.8.0_202\bin\java.exe

那第一个生效，说明有一份更靠前的路径抢走了。C:\Program Files\Common Files\Oracle\Java\javapath这个目录很典型，Oracle 的新版安装程序会自动往 Path 前面插入这条，指向一份独立的运行时。

处理方式有两种：

• 调整顺序：把%JAVA_HOME%\bin在 Path 列表里上移到那一条之前。注意 Path 列表的上下顺序就是优先级顺序。
• 临时指定：不折腾环境变量，直接用绝对路径或者临时覆盖：

set JAVA_HOME=C:\Dev\Java\jdk1.8.0_202 set PATH=%JAVA_HOME%\bin;%PATH% java -version

这种写法只在当前 cmd 窗口里生效，关掉就恢复，非常适合快速测试。

另外一个更隐蔽的坑是大小写和系统目录混淆。比如某些软件会在C:\Windows\System32里放一个java.exe，而 System32 通常在 Path 很靠前的位置。这种时候where java一眼就能看出来。

4.4 改完环境变量却不生效的原因

排在最前面的是旧终端没有刷新。你改环境变量的时候已经开着的 cmd、PowerShell、IDEA 甚至资源管理器，它们的进程环境块是在启动时拷贝的一份快照，改完之后不会自动刷新。解决办法：

• cmd / PowerShell：关掉重开。
• Explorer（资源管理器）：需要重启，或者在任务管理器里重启explorer.exe。
• IDE：完全退出再打开。IDEA 认不到新的 JDK 时，八成就是这个原因。

第二种是改错了区域。在用户变量里配了JAVA_HOME，但你的应用是以管理员身份或者别的账户运行的，读的是系统变量那一套，自然不生效。所以如果你用的是"以管理员身份运行"的 cmd，要往系统变量里配。

第三种是Path 总长度超限。Windows 有环境变量长度限制，路径太多会被截断。这种情况的诊断方式是看echo %PATH%输出的末尾有没有被切断的痕迹（比如最后一个路径明显不完整）。处理办法是精简掉不用的路径，或者把一些长路径改成用变量拼接。

第四种比较少见，是组策略或安全软件锁定了环境变量。公司统一管理的机器上可能出现，改完之后刷新一下就回去了。这种只能找 IT 处理。

5. 装完之后的配套动作与个人经验

环境变量配通不代表收工。下面这几步做掉，你才算真正拥有一套好用的 JDK8 环境。

5.1 命令行跑通第一个 Java 程序

这一步的目的是验证"编译 → 运行"整条链路。找个空目录，比如C:\code\demo，用记事本或者 VS Code 建一个HelloWorld.java：

public class HelloWorld { public static void main(String[] args) { System.out.println("JDK version: " + System.getProperty("java.version")); System.out.println("Java home: " + System.getProperty("java.home")); System.out.println("Classpath: " + System.getProperty("java.class.path")); } }

注意文件名必须和类名完全一致，包括大小写，HelloWorld.java对应HelloWorld。文件名错了会报类 HelloWorld 是公共的，应在名为 HelloWorld.java 的文件中声明。

然后在命令行里编译运行：

cd /d C:\code\demo javac -encoding UTF-8 HelloWorld.java java HelloWorld

-encoding UTF-8是必须的，因为 Windows 中文系统的默认编码是 GBK，而 VS Code 保存文件默认是 UTF-8。不加这个参数，源码里如果有中文注释就会出现"编码 GBK 的不可映射字符"的警告或者报错。

运行结果里那几个属性值非常有诊断价值：

• java.version输出1.8.0_202，说明生效的是 JDK8。
• java.home输出C:\Dev\Java\jdk1.8.0_202\jre，说明 JVM 是从你装的这套 JDK 里启动的。如果这里指向了别的地方，说明有另一套运行时在抢。
• java.class.path会显示当前生效的类路径，可以用来验证 CLASSPATH 有没有被正确读取。

5.2 在 IDE 里把项目 SDK 锁到 8

以常见的 IDE 为例，装完 JDK 之后，IDE 并不会自动使用它，需要手动指定。

基本流程是：打开设置 → 找到 SDK / JDK 配置入口 → 添加本地 JDK → 选择C:\Dev\Java\jdk1.8.0_202这个根目录。注意选的是 JDK 根目录，不是bin，也不是jre。

然后还要在项目级别指定两件事：

• Project SDK：选刚添加的 8。
• Language Level / 编译目标版本：选 8 对应的那个选项。

这两个不一样。SDK 决定用哪个编译器，Language Level 决定允许你用哪些语法特性。有些人 SDK 选的是 8，但 Language Level 是默认的高版本，代码里补全出来的语法在 8 上编译不过，就是这么来的。

还有一个容易忽略的点：IDE 里的 Maven 或 Gradle 也需要单独指定 JDK。IDE 的项目 SDK 和构建工具的 JDK 是两套配置。Maven 的settings.xml里可以配，也可以在 IDE 的构建工具设置里指定 runner 的 JRE。如果编译时报无效的目标发行版: 8或者source option 8 is no longer supported这类错误，基本就是构建工具用的 JDK 版本不对，用的是高版本 JDK 去编译目标 8 的代码。

我的习惯是在pom.xml里显式声明：

<properties> <maven.compiler.source>8</maven.compiler.source> <maven.compiler.target>8</maven.compiler.target> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties>

这样不管机器上装了哪些 JDK，编译目标都是明确的。

5.3 多版本切换的个人做法

如果你像我一样，一台机器上同时要维护 JDK8 和更高版本的项目，改来改去太烦。我的做法是写两个批处理文件放在桌面，需要哪个环境就双击一下：

use-jdk8.bat：

@echo off set JAVA_HOME=C:\Dev\Java\jdk1.8.0_202 set PATH=%JAVA_HOME%\bin;%PATH% echo Switched to: java -version cmd /k

use-jdk17.bat同理，换成 17 的路径。核心逻辑是set只在当前 cmd 会话里生效，不会污染系统环境变量，用完关窗口就恢复。最后的cmd /k是为了让窗口保留下来，方便接着敲命令。

如果你不想写脚本，另一个思路是保持系统变量只配一个版本（比如就配 8），其他版本在 IDE 里单独指定。这样命令行默认永远是最稳的那个，切换成本最低。

注意：不建议频繁修改系统级JAVA_HOME来做切换。每次改完都要重启所有相关程序，而且很容易忘记改回来，导致下一个项目莫名报错。

5.4 我踩过的几个坑

第一个坑：路径里的中文和括号。有一次我把 JDK 装在了D:\开发工具\jdk1.8.0_202下面，命令行单独用没问题，但跑 Maven 时一直报路径相关的错误，换成纯英文路径立刻就正常了。所以现在我统一用英文、无空格、无括号的目录。括号同样要避开，因为(x86)这种写法在某些批处理里需要转义。

第二个坑：用户变量和系统变量都配了一份。有次帮人排查，发现他用户变量和系统变量里各有一个JAVA_HOME，值还不一样。这种情况下用户变量会覆盖系统变量（对当前用户而言），所以看起来"系统变量改了不起作用"。排查时一定要两个区域都看一遍，set JAVA_HOME命令输出的值才是真正生效的那个。

第三个坑：Path 里的变量引用被展开了。有人在文本模式下编辑 Path 时，把%JAVA_HOME%\bin手动改成了实际路径。这本身没错，但以后一改JAVA_HOME，Path 里那条就不跟着变了，产生"我明明改了变量怎么还是老版本"的困惑。所以能保持变量引用就保持。

第四个坑：装完之后忘了重启终端就下结论。这个坑我踩过不止一次——改完变量立刻在当前窗口敲java -version，报错，然后开始怀疑人生，回去检查半天配置发现全对，最后发现只是窗口没重开。

把环境变量的当前值导出留档，也是我现在换机器必做的一步：

set > env_backup.txt

这个文件里包含当前会话的所有环境变量，重装系统或者换机器时对照着恢复，比凭记忆靠谱得多。特别是那些软件偷偷加进去的路径，你自己绝不会记得。