Windows 环境变量彻底讲清：PATH、用户变量与系统变量的区别、改完不生效怎么办
TL;DR
Windows 环境变量分两层：用户变量存在注册表 HKCU\Environment，改动不需要管理员权限；系统变量存在 HKLM 下，需要管理员。PATH 是两者按「系统在前、用户在后」拼接出来的。改完不生效，最常见的原因是已打开的终端不会自动刷新——重开一个新终端即可，不用重启电脑。脚本里设置用户级变量推荐 [Environment]::SetEnvironmentVariable("JAVA_HOME", "D:\jdk", "User")，别用 setx（值超过 1024 字符会被截断）。
环境变量是什么？终端是怎么找到 git.exe 的
环境变量是操作系统交给每个进程的一组键值对，程序靠它找文件、找配置、认路。
以最常见的 PATH 为例：当你在终端输入 git，shell 并不知道 git.exe 装在哪。它做的事是把 PATH 变量按分号拆成一个目录列表，从头到尾挨个目录找 git.exe（cmd 还会按 PATHEXT 变量补全 .exe、.bat 等后缀），第一个命中的就执行；一个都找不到，就报那句经典的「'git' 不是内部或外部命令」。所以装完 Git 提示找不到命令，多半不是没装上，而是安装目录没进 PATH。
除了 PATH，开发中常打交道的还有 JAVA_HOME（Maven、Gradle 靠它定位 JDK）、GOPATH、HTTP_PROXY 等，原理相同：都只是进程启动时拿到的一份键值对。
用户变量和系统变量有什么区别？
区别就三点：存储位置、生效范围、改动权限。
| 用户变量 | 系统变量 | |
|---|---|---|
| 存储位置 | HKCU\Environment | HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment |
| 生效范围 | 仅当前登录用户 | 本机所有用户 |
| 改动权限 | 不需要管理员 | 需要管理员（UAC） |
优先级规则：同名变量，用户变量覆盖系统变量。比如用户级设了 TEMP，系统级那份就被遮住了。
唯一的例外是 PATH：它不是覆盖，而是拼接——运行时 PATH = 系统 PATH + ; + 用户 PATH。这个顺序意味着两边都有同名程序时，系统 PATH 里的先命中（后文细讲）。
实际建议：给自己装开发工具，写用户变量就够了——效果一样，还不用过 UAC 弹窗。
环境变量怎么设置？四种方法对比
日常改一两个值用图形界面，写脚本用 PowerShell，setx 有坑要绕着走，直接改注册表留给排查问题时用。
图形界面怎么改？
按 Win 键搜「环境变量」，会出来两个入口：「编辑账户的环境变量」（只改用户变量，免管理员）和「编辑系统环境变量」（需要管理员）。也可以直接运行 rundll32 sysdm.cpl,EditEnvironmentVariables 打开前者。
改 PATH 的步骤：选中 Path → 编辑 → 新建 → 粘贴目录路径 → 确定。注意最后要把所有对话框都点「确定」关掉——最外层点了「取消」或右上角叉掉，前面的改动全部作废。
setx 有什么坑？
setx 能用，但有三个坑，其中一个是破坏性的：
setx JAVA_HOME "D:\jdk" :: 写用户变量
setx JAVA_HOME "D:\jdk" /M :: 写系统变量，需要管理员- 值超过 1024 字符直接截断。setx 会打一行 WARNING，但脚本里没人看——PATH 稍微长一点，后半段就被剪掉了，等于改一次坏一次；
setx PATH "%PATH%;D:\foo"是常见错误写法：%PATH%展开的是系统 + 用户拼接后的完整值，整个写回用户 PATH 会导致目录大量重复，还容易触发上面的截断；- setx 只写注册表，当前窗口不生效——这不是 bug，原因见下一节。
PowerShell 怎么设置环境变量？
[Environment]::SetEnvironmentVariable 是脚本里最稳的方式：没有 1024 字符限制，写完自动广播生效通知。
# 设置用户级变量
[Environment]::SetEnvironmentVariable("JAVA_HOME", "D:\jdk", "User")
# 向用户 PATH 追加目录（只读写 User 一层，不混入系统 PATH）
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;D:\tools\bin", "User")注意区分：$env:Path = "..." 只改当前进程的环境块，窗口一关就没了；写注册表才是持久化。
直接改注册表行不行？
行，但改完不会自动生效。用户变量在 HKCU\Environment，系统变量在 HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment，用 regedit 或 reg add 都能改。两个注意点：
- PATH 的值类型应保持
REG_EXPAND_SZ，值里的%USERPROFILE%这类引用才会被展开； - 直接改注册表不会发 WM_SETTINGCHANGE 广播，改完随手执行任意一条 setx（它会顺带广播），或者注销重登，新终端才能读到。
为什么环境变量改完不生效？
因为环境变量不是全局实时共享的——每个进程在启动那一刻从父进程复制一份环境块，之后注册表怎么改都影响不到已经在跑的进程。完整的生效链条是：注册表 →（WM_SETTINGCHANGE 广播）→ Explorer 刷新自己的环境块 → 新开的终端从 Explorer 继承 → 终端里的命令再从终端继承。三个环节各有一个坑。
原因一：已打开的终端永远不会刷新
重开一个新终端，绝大多数「不生效」到此解决。传统 cmd 窗口从 Explorer 继承环境；Windows Terminal 1.17 起默认在新建标签页时重新加载环境变量（compatibility.reloadEnvironmentVariables 设置项）。如果当前窗口等不及重开，可以手动重读注册表：
$env:Path = [Environment]::GetEnvironmentVariable("Path", "Machine") + ";" +
[Environment]::GetEnvironmentVariable("Path", "User")原因二：从旧进程启动的程序，继承的还是旧环境
VS Code 集成终端里不生效、重启终端面板也没用？要把 VS Code 整个退出重开——集成终端继承的是 VS Code 主进程的环境块，主进程还是老的，新面板也是老的。同理还有：从旧终端里 code . 拉起的编辑器（这时还得先重开那个终端）、Windows 服务（从 services.exe 继承，改完要重启服务）。排查时沿着「谁启动了谁」这条继承链往上找就对了。
原因三：改注册表的方式没有广播 WM_SETTINGCHANGE
图形界面、setx、.NET API 改完都会向所有顶层窗口广播 WM_SETTINGCHANGE 消息，Explorer 收到后刷新自己的环境块，之后新开的终端才能拿到新值。直接用 regedit / reg add 改的没有这一步——哪怕开一百个新终端也读不到，要么手动触发一次广播（跑一条 setx），要么注销重新登录。
PATH 里有两个同名程序，哪个生效？
排在前面的目录先命中，后面的永远轮不到——而且系统 PATH 整体排在用户 PATH 前面。诊断命令：
where git # cmd：按命中顺序列出全部匹配
Get-Command git -All # PowerShell 等价命令第一行就是你输入 git 时实际执行的那个。装了多个版本行为诡异时，先跑这条。
为什么输入 python 会弹出 Microsoft Store？
因为用户 PATH 里默认有 %LOCALAPPDATA%\Microsoft\WindowsApps，里面放着 python.exe / python3.exe 的「应用执行别名」——0 字节的占位文件，作用就是打开商店页面。你装的真 Python 如果排在它后面，输入 python 命中的是别名而不是解释器。
两个解法：设置 → 应用 → 高级应用设置 → 应用执行别名，关掉 python.exe 和 python3.exe；或把真实 Python 的目录在用户 PATH 里挪到 WindowsApps 之前。被这个问题反复困扰的话，可以看看用 uv 管理 Python 版本的方案。
不想手动管这些？hudo 的做法
hudo 安装工具时自动把环境变量写到用户级 HKCU\Environment——26 款工具全程免管理员权限（数据库服务注册除外），写完立即广播 WM_SETTINGCHANGE，卸载时再从 PATH 里逆向清掉对应目录，JAVA_HOME 这类变量也在装 JDK 时顺手配好：
irm hudo.zexa.cc/install.ps1 | iex本文讲的原理不会变，但手动操作可以省掉。
常见问题
设置环境变量需要重启电脑吗？
不需要。图形界面、setx 或 PowerShell 改完，重开终端就能用；只有直接改注册表没广播，或者改的是 Windows 服务依赖的变量时，才需要注销重登或重启服务。
setx 和 set 有什么区别？
set 只改当前 cmd 会话，窗口一关就没了；setx 写注册表持久生效，但反过来不影响当前会话。要「现在能用、以后也在」，两条得配合着来。
用户 PATH 和系统 PATH 里有同名程序，谁生效？
系统 PATH 里的。运行时 PATH 按「系统在前、用户在后」拼接，查找从头开始，系统那份先命中。
怎么不重开终端就让新 PATH 生效？
PowerShell 里重读注册表拼接后赋给 $env:Path（命令见上文）。cmd 没有干净的等价做法，装了 Chocolatey 的话可以用它附带的 refreshenv。
环境变量的值有长度限制吗？
单个变量值上限约 32767 字符，日常碰不到；真正常撞上的是 setx 的 1024 字符截断——那是 setx 自身的限制，不是系统的。