添加新路径到Path环境变量时如何保留原有变量引用不被展开

问题原因 #

Environment.GetEnvironmentVariable 方法读取环境变量时会自动展开所有%变量名%格式的引用，返回的是展开后的实际路径，所以直接用这个方法读取再写回就会丢失原来的变量占位符。
系统环境变量实际存储在注册表中，系统级Path项是REG_EXPAND_SZ类型，默认读取会自动展开，只要我们直接操作注册表读取原始未展开的值，修改后再写回就能保留变量引用。

实现代码 #

using Microsoft.Win32;
using System;
using System.Runtime.InteropServices;

class PathUpdateExample
{
    // 导入系统API，用于通知系统环境变量变更
    [DllImport("user32.dll", SetLastError = true)]
    private static extern IntPtr SendMessageTimeout(IntPtr hWnd, uint Msg, UIntPtr wParam, string lParam, uint fuFlags, uint uTimeout, out UIntPtr lpdwResult);

    private const uint WM_SETTINGCHANGE = 0x001A;
    private const uint SMTO_ABORTIFHUNG = 0x0002;

    static void Main(string[] args)
    {
        string newPath = @"C:\my\new\path";
        bool isSystemLevel = true; // 改为false则操作用户级Path

        // 打开对应的注册表项
        using (RegistryKey regKey = isSystemLevel 
            ? Registry.LocalMachine.OpenSubKey(@"SYSTEM\CurrentControlSet\Control\Session Manager\Environment", true)
            : Registry.CurrentUser.OpenSubKey(@"Environment", true))
        {
            if (regKey == null)
            {
                Console.WriteLine("无法打开注册表项，检查是否有管理员权限");
                return;
            }

            // 读取未展开的原始Path值，第三个参数指定不展开环境变量
            string originalPath = regKey.GetValue("Path", "", RegistryValueOptions.DoNotExpandEnvironmentNames) as string;

            // 避免重复添加路径
            if (!originalPath.Contains(newPath))
            {
                string updatedPath = originalPath + ";" + newPath;
                // 写回注册表，指定值类型为REG_EXPAND_SZ，保留变量展开能力
                regKey.SetValue("Path", updatedPath, RegistryValueKind.ExpandString);
                Console.WriteLine("Path更新成功");
            }
            else
            {
                Console.WriteLine("路径已存在，无需重复添加");
            }
        }

        // 通知系统环境变量已更新，无需重启即可生效
        UIntPtr result;
        SendMessageTimeout((IntPtr)0xffff, WM_SETTINGCHANGE, UIntPtr.Zero, "Environment", SMTO_ABORTIFHUNG, 5000, out result);
    }
}

注意事项 #

• 修改系统级Path时需要以管理员身份运行程序，否则无法写入HKLM注册表节点
• 代码中的RegistryValueOptions.DoNotExpandEnvironmentNames是核心参数，确保读取时不展开变量引用
• 写回注册表时指定RegistryValueKind.ExpandString，保证后续系统读取时还能正常识别变量占位符

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