配置用户级和系统级环境变量，让终端和程序找到正确路径

适用场景

命令行提示“不是内部或外部命令”但程序已安装、需要设置 JAVA_HOME/PYTHONPATH/代理、或服务读到的变量与当前终端不一致时使用。不要把所有工具目录都塞进系统 PATH，也不要反复用 setx PATH "%PATH%;..."：它覆盖写入，拼接错误会丢失条目或截断 PATH。

前置条件

• 修改系统级变量需要管理员；用户级变量只影响当前用户。
• 先记录原值：当前进程用 echo %PATH%，持久值查注册表或图形界面。
• 关闭并重开终端；已运行的服务要重启才能读到新值。
• 用户变量与系统变量同名时，用户值通常覆盖系统值，PATH 则是拼接关系。

操作步骤

1. 图形界面

Win+R 输入 sysdm.cpl →“高级”→“环境变量”。上半部分是用户变量，下半部分是系统变量；选中 Path 点“编辑”，用列表逐条添加，避免整段字符串拼接。

2. 当前会话临时变量

C:\> set JAVA_HOME
C:\> set PATH=%PATH%;C:\Tools\bin
C:\> echo %JAVA_HOME%

set 只影响当前命令行窗口，关闭即失效，适合临时测试。

3. 持久化用户和系统变量

C:\> setx JAVA_HOME "C:\Program Files\Java\jdk-21"
C:\> setx MY_TOOLS "%USERPROFILE%\Tools"
C:\> setx /M JAVA_HOME "C:\Program Files\Java\jdk-21"
C:\> reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path

setx 写入后不影响当前窗口；值超过 1024 字符时旧版 setx 可能截断。

4. PowerShell 精确写入

PS C:\> $old = [Environment]::GetEnvironmentVariable("Path","User")
PS C:\> [Environment]::SetEnvironmentVariable("Path", $old + ";C:\Tools\bin", "User")

影响范围：setx /M PATH ... 会改写所有用户和服务的 PATH。先 reg export 备份 HKCU\Environment 和 HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment，再用图形界面追加。

验证

• 新开 cmd，执行 echo %JAVA_HOME% 和 where java，确认路径和顺序。
• where <命令> 列出所有匹配项，检查 PATH 中是否混有旧版本。
• PS C:\> Get-Command java | Select-Object Source 查看实际解析到的可执行文件。

回滚与风险

• 改前备份两个注册表键（reg export）；回滚时导入备份或手工恢复原值。
• setx 是覆盖不是追加；写错系统 PATH 可能让新终端找不到系统命令，需用完整路径打开 regedit 修复。
• 系统 PATH 影响服务和开机流程，错误值可能让机器启动异常；保留还原点，必要时用 WinRE。
• 含空格的变量值加引号，并在图形界面核对 setx 是否把引号也写进了值。

相关命令

• set — 查看和临时设置当前会话变量
• setx — 持久化用户/系统变量
• where — 按 PATH 查找可执行文件
• wsl — WSL 与 Windows 环境变量互通
• bash-cheatsheet — Linux 变量与导出对照
• systemd-cheatsheet — 服务环境变量配置

参考链接

• Microsoft Learn: setx
• Microsoft Learn: set
• Microsoft Learn: about_Environment_Variables

读完自测

合上页面，先回答，再展开对照。

1. set 和 setx 的作用范围有什么区别？
2. 为什么 setx PATH "%PATH%;C:\Tools" 很危险？
3. 修改系统环境变量后，已运行的服务为什么读不到新值？