setx 是干什么的
set 只在当前 CMD 会话里改环境变量，setx 则是把变量写进注册表实现持久化：默认写用户级（HKCU），加 /M 写系统级（HKLM，需管理员）。写入后新开的进程与窗口才会读到新值，已经打开的窗口不受影响。它最大的坑是长度限制与 PATH 被展开写死的问题，改 PATH 这类长变量要格外谨慎。
基本信息
| 适用平台 | Windows 全版本（setx 自 Windows XP 起提供） |
|---|---|
| 语法 | setx 变量 值 [/M] |
| 作用域 | 默认当前用户；/M 为系统级（需管理员） |
| 生效时机 | 新开的进程/窗口；当前会话不生效 |
| 长度限制 | 值上限 1024 字符，超出部分被截断 |
典型使用场景
- 配置开发环境：设置 JAVA_HOME、GOROOT 等长期变量
- 统一工具路径：把内部工具目录写入 PATH（推荐用 GUI 或 PowerShell）
- 脚本部署：安装程序中给用户或系统补充必需变量
- 排查变量异常：确认某个变量是会话级还是持久化设置
- 临时验证：先 set 在当前窗口测试，确认无误再用 setx 持久化
常用示例
常用示例
:: 用户级持久化
setx JAVA_HOME "C:\Program Files\Java\jdk-17"
:: 系统级（需管理员）
setx /M JAVA_HOME "C:\Program Files\Java\jdk-17"
:: 查看当前值与持久化值是否一致
set JAVA_HOME
echo %JAVA_HOME%
reg query "HKCU\Environment" /v JAVA_HOME
:: 修改 PATH 更安全的方式（PowerShell，先取现值再拼接）
powershell -c "[Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path','User') + ';D:\tools','User')"set 与 setx 对比
| 项目 | set | setx |
|---|---|---|
| 生效范围 | 当前会话 | 新开的进程/窗口 |
| 是否持久 | 否 | 是，写入注册表 |
| 长度限制 | 受命令行长度限制 | 1024 字符 |
| 是否展开变量 | 立即展开 | 写值前会展开一次，注意副作用 |
| 适用场景 | 临时测试 | 长期配置 |
setx PATH "%PATH%;D:\tools" 会把“系统 PATH + 用户 PATH”展开后写死进用户 PATH，并把超过 1024 字符的部分静默截断，极易造成 PATH 损坏、大量命令找不到。修改 PATH 请用系统属性界面或 PowerShell 的 SetEnvironmentVariable 方法。
改完变量在当前窗口里看不到变化是正常现象，不要重复执行 setx。先关掉旧窗口，再新开一个 CMD 或 PowerShell 验证，或者注销重新登录以确保资源管理器继承到新值。
操作系统级变量前先导出备份：reg export "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" D:\env_backup.reg。环境变量出问题会导致大量程序无法启动，回滚成本高。