Windows 追加目录到 PATH：CMD 和 PowerShell 的正确姿势

Windows 上装完 Maven / Java / Python，最常做的一件事就是把 bin 目录塞进 PATH。老一辈教程都写 setx PATH "%PATH%;..."，看着能跑，实际有个特别坑的边界。

CMD 方式：setx

追加到当前用户 PATH：

setx PATH "%PATH%;D:\soft\apache-maven-3.9.15\bin"

追加到系统 PATH（需要管理员 CMD）：

setx /M PATH "%PATH%;D:\soft\apache-maven-3.9.15\bin"

新开的 CMD 才能读到。当前窗口立即用：

set PATH=%PATH%;D:\soft\apache-maven-3.9.15\bin
mvn -v

setx 的两个坑

1. 会展开 %PATH%，把用户和系统 PATH 混起来

%PATH% 在 CMD 里是 系统 + 用户 PATH 的合并结果。你 setx PATH "%PATH%;X" 会把两份合起来写到用户 PATH 里，重复且混乱。

2. 1024 字符截断

setx 有个硬伤：值超过 1024 字符会静默截断。老系统 PATH 已经很长，一次 setx 直接把后半段吞掉。

PowerShell 方式（推荐）

[Environment]::SetEnvironmentVariable 更精确——读用户就读用户、写用户就写用户，也没 1024 字符限制。

追加到当前用户 PATH：

$addPath = "D:\soft\apache-maven-3.9.15\bin"
$current = [Environment]::GetEnvironmentVariable("Path", "User")

if ($current -notlike "*$addPath*") {
    [Environment]::SetEnvironmentVariable("Path", "$current;$addPath", "User")
    Write-Host "已追加：$addPath"
} else {
    Write-Host "PATH 已存在该目录"
}

• -notlike "*X*" 防止重复添加
• "User" 参数明确只改用户 PATH，不动系统 PATH

追加到系统 PATH（管理员 PowerShell）：

$addPath = "D:\soft\apache-maven-3.9.15\bin"
$current = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($current -notlike "*$addPath*") {
    [Environment]::SetEnvironmentVariable("Path", "$current;$addPath", "Machine")
}

当前会话立刻生效：

$env:Path += ";D:\soft\apache-maven-3.9.15\bin"
mvn -v

通用检查

# 看用户 PATH
[Environment]::GetEnvironmentVariable("Path", "User") -split ";"

# 看系统 PATH
[Environment]::GetEnvironmentVariable("Path", "Machine") -split ";"

# 看合并后的 PATH
$env:Path -split ";"

去重：

$env:Path -split ";" | Where-Object { $_ } | Sort-Object -Unique

移除某条

用户 PATH 里删掉某条：

$remove  = "D:\soft\apache-maven-3.9.15\bin"
$paths   = ([Environment]::GetEnvironmentVariable("Path","User") -split ";") |
           Where-Object { $_ -ne $remove -and $_ }
[Environment]::SetEnvironmentVariable("Path", ($paths -join ";"), "User")

一句话总结

• CMD 只是想加一条：setx PATH "%PATH%;X"，小心 1024 截断
• 认真加：管理员 PowerShell + [Environment]::SetEnvironmentVariable 显式指定 User/Machine
• 加完记得新开终端才能读到；当前窗口用 $env:Path += ";X"