PowerShell设置用户PATH时%JAVA_HOME%\bin未正常展开问题求解

我正在编写一款PowerShell脚本，用于在Windows系统中自动配置最新版Java与JavaFX运行环境，脚本执行流程如下：

• 从jdk.java.net与gluonhq.com站点获取Java、JavaFX的最新版本信息
• 分别从对应源下载安装压缩包
• 将压缩包解压到系统指定的安装路径
• 删除已完成解压的安装压缩包
• 更新用户环境变量JAVA_HOME与PATH_TO_FX
• 向用户环境变量PATH中追加%JAVA_HOME%\bin条目

上述步骤1-5均可按预期正常执行，但步骤6出现异常，该步骤对应脚本末尾的实现代码如下：

$p = [Environment]::GetEnvironmentVariable("PATH", [EnvironmentVariableTarget]::User)
$p = $p.Split(";", [System.StringSplitOptions]::RemoveEmptyEntries)
$p += "%JAVA_HOME%\bin"
$p = ($p -join ";") + ";"
<# [Environment]::SetEnvironmentVariable("PATH", $p, [EnvironmentVariableTarget]::User) #>
<# Set-ItemProperty HKCU:\Environment -Name "PATH" -Value $p -Type ExpandString #>
setx PATH "$p"

已尝试方案的问题 #

• 第一行被注释的SetEnvironmentVariable方法：默认会将对应注册表值的类型设置为REG_SZ（默认字符串类型），该类型无法自动解析%%包裹的变量占位符，包含这类占位符的条目需要注册表值类型为REG_EXPAND_SZ（可扩展字符串类型）才能正常展开，因此该方案无效。
• 第二行被注释的Set-ItemProperty方法：虽然可以将注册表值类型设置为正确的ExpandString（对应REG_EXPAND_SZ），但启动全新PowerShell实例执行(dir env:PATH).Value验证环境变量生效情况时，PATH变量中完全没有显示追加的%JAVA_HOME%\bin条目（无论是否展开）；但直接查看注册表、通过控制面板 > 系统属性查看环境变量配置时，两处都能看到%JAVA_HOME%\bin条目已存在，该现象原因暂不明确。
• 目前只有调用setx命令的方案可以正常实现需求，我并不排斥使用setx，但希望了解是否有符合PowerShell最佳实践的原生实现方式？查到有案例使用和我完全相同的Set-ItemProperty写法且正常生效，是否是操作顺序问题（该案例中先调用Set-ItemProperty再调用SetEnvironmentVariable）？

Set-ItemProperty方案未生效的核心原因 #

直接通过Set-ItemProperty修改注册表写入PATH后新窗口读不到条目，本质是Windows环境变量的更新通知机制问题：
直接编辑HKCU:\Environment注册表路径的操作，不会自动向系统内所有顶层窗口发送WM_SETTINGCHANGE广播消息，资源管理器、后续新启动的进程不会自动刷新从父进程继承的环境变量块。你在注册表和控制面板里能看到新增条目，说明写入操作本身是成功的，只是缺少通知步骤，导致新启动的PowerShell仍然加载了旧的环境变量缓存。调用setx时系统会自动发送这个广播，所以你用setx时能立刻生效。
另外要注意：如果之前用SetEnvironmentVariable把用户PATH的注册表类型改成了REG_SZ，就算后续改回REG_EXPAND_SZ，部分Windows版本的环境变量加载逻辑也可能出现解析异常，操作前最好先确认注册表中HKCU:\Environment\Path的值类型为可扩展字符串。

PowerShell原生实现方案 #

不需要依赖setx，原生实现只要完成正确写入可扩展字符串值、手动发送环境变量更新广播两个步骤即可，参考代码如下：

# 直接从注册表读取当前用户PATH，避免[Environment]::GetEnvironmentVariable自动展开变量导致%JAVA_HOME%被硬编码为实际路径
$regUserEnv = 'HKCU:\Environment'
$currentPath = (Get-ItemProperty -Path $regUserEnv -Name Path).Path
# 清理PATH条目：移除空值、去重已存在的%JAVA_HOME%\bin避免重复添加
$pathEntries = $currentPath.Split(';', [StringSplitOptions]::RemoveEmptyEntries) | Where-Object { $_ -and $_ -ne '%JAVA_HOME%\bin' }
$pathEntries += '%JAVA_HOME%\bin'
$newPath = $pathEntries -join ';'
# 写入REG_EXPAND_SZ类型的PATH值，保证变量占位符能被正常解析
Set-ItemProperty -Path $regUserEnv -Name Path -Value $newPath -Type ExpandString

# 调用Win32 API发送WM_SETTINGCHANGE广播，通知所有进程环境变量已更新
Add-Type -TypeDefinition @"
using System;
using System.Runtime.InteropServices;
public class Win32Api {
    [DllImport("user32.dll", SetLastError = true, CharSet = CharSet.Auto)]
    public static extern IntPtr SendMessageTimeout(IntPtr hWnd, uint Msg, UIntPtr wParam, string lParam, uint fuFlags, uint uTimeout, out UIntPtr lpdwResult);
}
"@
$HWND_BROADCAST = [IntPtr]0xffff
$WM_SETTINGCHANGE = 0x1A
$callResult = [UIntPtr]::Zero
[Win32Api]::SendMessageTimeout($HWND_BROADCAST, $WM_SETTINGCHANGE, [UIntPtr]::Zero, "Environment", 2, 5000, [ref]$callResult) | Out-Null

注意：不要在写入注册表后调用[Environment]::SetEnvironmentVariable，该方法会把你刚设置好的REG_EXPAND_SZ类型值重新覆盖为REG_SZ，直接导致%JAVA_HOME%这类变量占位符无法展开。你提到的先写注册表再调用SetEnvironmentVariable的写法是错误的，会直接破坏可扩展字符串的配置。

内容的提问来源于stack exchange，提问作者Fernando Sanchez