装完软件改了 PATH,重开一个窗口还是提示找不到命令;或者 set 完变量,一关窗口就没了。问题通常不在「有没有写进去」,而在「哪一层进程读到了新值」。读之前需要会:set 查看变量、在「系统属性 → 环境变量」里加过条目、知道批处理里的 %VAR% 是什么。
实验只动自建的 CMDF4_ 前缀变量:用户级四个、机器级一个,最后用 reg delete 全部删掉,不碰 PATH,也不改任何已有变量。测试脚本在 E:\cmd-demo\env,setup.ps1 重建 session.bat、expand.bat、paths.bat、long.bat。
set 只活在当前窗口,setx 写进注册表但不改当前窗口
E:\cmd-demo\env>session.bat
current=[]
after-set=[window-only]
after-setx=[window-only]
E:\cmd-demo\env>reg query "HKCU\Environment" /v CMDF4_TEST
HKEY_CURRENT_USER\Environment
CMDF4_TEST REG_SZ stored-value
set CMDF4_TEST=window-only 只改当前 cmd 进程的内存,退出即消失;setx CMDF4_TEST stored-value 写的是 HKCU\Environment,注册表里已经是 stored-value,但运行 setx 的那个窗口仍然显示旧值。想让当前窗口立刻用上新值,只能再执行一次 set。
卸载变量正好相反:setx 没有删除功能,setx CMDF4_TEST "" 会留下一个空值条目;要真正删掉得用 reg delete "HKCU\Environment" /v CMDF4_TEST /f,或者到环境变量对话框里删。
同一个写错或没写完的 %VAR%,命令行和批处理的处理方式还不一样:
E:\cmd-demo\env>echo cmdline=[%CMDF4_NOPE%]
cmdline=[%CMDF4_NOPE%]
E:\cmd-demo\env>undef.bat
batch=[]
交互式命令行里,未定义的变量原样保留;批处理里则展开成空字符串。排查时看到输出里带着 %XXX%,说明这个变量根本没有值,而不是值里恰好有百分号。
setx 超过 1024 字符只警告,退出码仍然是 0

E:\cmd-demo\env>long.bat
警告: 正保存的数据被裁断到 1024 字符。
E:\cmd-demo\env>reg query "HKCU\Environment" /v CMDF4_LONG
CMDF4_LONG REG_SZ aaaaa...(1024 个 a)
1200 个字符写进去,只剩 1024 个,警告打在 stderr,但 setx 的退出码是 0。脚本里用 if errorlevel 1 判断失败会把这种截断当成成功。
这条限制直接影响 PATH 的改法。网上常见的 setx PATH "%PATH%;C:\new\bin" 有三个问题:%PATH% 在写入前就被展开成当前进程的旧值(机器级 + 用户级拼在一起),新值整个写进用户变量;超过 1024 字符会被裁断;机器级的部分被复制进用户级,之后两边再改就容易重复。实测 setx CMDF4_PCT "%USERPROFILE%\logs" 存进去的是 C:\Users\jsx13\logs,说明变量引用在写入那一刻就展开了,不是留到读取时再算。
改 PATH 更稳的做法是在「环境变量」对话框里编辑用户 PATH(它不会动机器级条目),或者先 echo %PATH% 看清内容、只追加自己那一段;不要拿 %PATH% 回写。
setx /M 写机器级,必须管理员

E:\cmd-demo\env>setx CMDF4_ERR
错误: 无效语法。
键入 "SETX /?" 了解用法信息。
E:\cmd-demo\env>setx /M CMDF4_MACHINE machine-value
成功: 指定的值已得到保存。
参数错误走 stderr、退出码 1;/M 成功提示走 stdout、退出码 0。/M 写的是 HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment,需要在提权窗口里执行,普通权限会因写不进去而失败;不加 /M 只写当前用户的 HKCU\Environment。本机的机器级变量是自建的 CMDF4_MACHINE,验证后已删除。
新开的窗口也可能是旧值:环境块在进程启动时复制
Windows 不提供「全局环境变量」这种实时对象。每个进程启动时,父进程把自己的一份环境块复制给它;之后注册表再变,也不会自动回写到已存在的进程。所以以下几种「新窗口」拿到的值并不一样:
| 从哪启动 | 看到的值 |
|---|---|
| 已经开着的 cmd / PowerShell | 旧值,setx 不会改它 |
从这个旧窗口里 start 新窗口 |
旧值,子进程复制父进程的环境块 |
| 从资源管理器/开始菜单新开 | 新值,Explorer 收到 WM_SETTINGCHANGE 后已刷新自己的环境块 |
| 已经运行的服务、计划任务 | 多数还是旧值,要重启服务或重新登录 |
直接 reg add 写注册表 |
全都没变,写注册表不会广播刷新消息 |
这解释了「重开窗口还是不行」:如果新窗口是从旧 cmd 里 start 出来的,它继承的仍然是旧环境块。想让所有新进程都看到,注销再登录最彻底;只改用户变量时,重启 Explorer 也能让开始菜单启动的进程拿到新值。验证时别猜,在目标窗口里 set CMDF4_TEST 看实际值。
%VAR% 在块里只展开一次,!VAR! 才跟得上循环
E:\cmd-demo\env>expand.bat
percent=0 delayed=1
percent=0 delayed=2
percent=0 delayed=3
for 或 if 的括号块在解析时就把 %N% 替换掉了,所以循环里改 N,%N% 永远显示进入循环前的 0;开启 setlocal EnableDelayedExpansion 后用 !N!,才会在每次执行时取当前值。脚本里出现「循环里变量不变」几乎都是这个原因,和 setx 无关。
%CD% 是当前目录,%~dp0 才是脚本所在目录
E:\cmd-demo>E:\cmd-demo\env\paths.bat
CD=E:\cmd-demo
DP0=E:\cmd-demo\env\
USERPROFILE=C:\Users\jsx13
APPDATA=C:\Users\jsx13\AppData\Roaming
TEMP=C:\Users\jsx13\AppData\Local\Temp
从 E:\cmd-demo 调脚本,%CD% 是调用者的当前目录,%~dp0 固定是脚本所在的 E:\cmd-demo\env\(带末尾反斜杠)。批处理里读写同目录文件一律用 %~dp0,否则换个目录双击就找不到文件。%APPDATA% 是漫游目录 Roaming,%LOCALAPPDATA% 是本机目录,缓存和日志通常放后者;%TEMP% 也是按用户分开的。
变量名不分大小写,set 裸执行列出全部 138 条
E:\cmd-demo\env>set path
Path=d:\soft\Trae CN\...;C:\Windows\system32;...
set path 和 set PATH 等价,取到的是同一个值,显示的字母大小写取决于当初写入时怎么写的。set 不带参数会按名称排序列出当前进程的全部变量,本机是 138 条,包含很多内部使用的条目;找某个变量用 set 名称,需要过滤时再管道给 findstr。set 列的是「这个进程当前看到的」,不是注册表里的全部,拿来对照新旧窗口很方便。
PATH 改完仍找不到程序,多半是进程还没换环境
PATH 只是众多变量中的一个,它的特殊之处在于命令解析会按当前进程的 PATH 逐个目录找可执行文件。setx PATH ... 之后:
- 当前窗口继续用旧 PATH,
命令仍然找不到; - 从当前窗口
start的新窗口也还是旧 PATH; - 从开始菜单新开的窗口才会用新 PATH;
- 已经跑着的 IDE、终端、服务,要重启对应程序。
所以「改完 PATH 不生效」通常不是 PATH 写错,而是执行命令的那个进程还拿着旧环境块。至于程序到底装在哪个目录、PATH 里顺序怎么排,属于「命令找不到」的另一条线,A5 已经讲过,这里只确认变量有没有传到目标进程。真要核对,就在目标窗口 echo %PATH%,看新加的目录在不在。
排查顺序可以固定成:当前窗口 set 变量名 看有没有 → reg query HKCU\Environment /v 变量名 看写没写进去 → 换一个从资源管理器新开的窗口再看 → 还不行就看目标进程是不是服务或旧窗口的子进程。记住 set 管当前进程、setx 管注册表,两者之间隔着一次进程启动。
下一篇换到文件本身:两个文件内容到底一样吗、有没有被改过,用 fc /b、comp、certutil -hashfile 和 Get-FileHash 怎么比对。