用powershell修改系统级环境变量需以管理员权限运行，调用[environment]::setenvironmentvariable("变量名","值","machine")，推荐用于设置新变量或追加path；修改后需新开终端生效并验证。
用 powershell 修改系统级环境变量，核心是调用 [environment]::setenvironmentvariable() 并指定作用域为 "machine"，同时必须以管理员权限运行。直接改注册表或用 setx /m 也可行，但 .net 方法更稳定、无字符长度限制，也更适合脚本化操作。
必须以管理员身份运行 PowerShell
系统级变量写入 HKEY_LOCAL_MACHINE，普通用户无权限。右键“开始”菜单 → 选择“Windows PowerShell（管理员）”，或在搜索栏中输入 PowerShell，右键选择“以管理员身份运行”。没权限时命令会静默失败或报错。
添加或修改系统变量（推荐方式）
使用 [Environment] 类是最稳妥的做法，不会截断长路径，也不会误覆盖原有值：
- 设置新变量（如
JAVA_HOME）：[Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Program Files\Java\jdk-17.0.9", "Machine") - 向系统 PATH 追加路径（不覆盖原有内容）：
$old = [Environment]::GetEnvironmentVariable("PATH", "Machine")<br>[Environment]::SetEnvironmentVariable("PATH", "$old;C:\mytool\bin", "Machine")
避免重复添加的实用检查
多次执行脚本容易重复追加路径，可用以下逻辑提前判断：
$target = "C:\mytool\bin"$current = [Environment]::GetEnvironmentVariable("PATH", "Machine")if ($current -notlike "*$target*") { [Environment]::SetEnvironmentVariable("PATH", "$current;$target", "Machine") }
生效与验证
修改后需新开一个 PowerShell 或 CMD 窗口才能看到变化。验证方法：
- 在新窗口中运行：
$env:PATH（PowerShell）或echo %PATH%（CMD） - 检查是否包含刚添加的路径
- 运行对应工具命令（如
java -version）确认可执行文件被识别
