如何在Windows 11中通过Python原生命令永久设置环境变量

首先明确：Python没有内置的一键式API直接完成永久环境变量设置，但可以通过标准库的winreg模块直接操作Windows注册表实现，这属于Python原生方案，无需调用subprocess或os.system执行外部命令。

为什么os.environ只能临时生效 #

你当前用os.environ['USER'] = 'username'修改的只是当前Python进程的环境变量，属于内存中的临时状态，进程结束后就会消失，不会写入系统的永久存储位置。

用winreg实现永久设置的示例 #

Windows的永久环境变量分为用户级别（仅对当前用户生效）和系统级别（对所有用户生效，需管理员权限），分别对应不同的注册表路径，以下是两种场景的实现代码：

1. 设置用户级环境变量

import winreg
import ctypes

def set_user_env_var(var_name, var_value):
    # 打开用户环境变量对应的注册表项
    with winreg.OpenKey(winreg.HKEY_CURRENT_USER, 'Environment', 0, winreg.KEY_SET_VALUE) as key:
        # 写入环境变量值，REG_EXPAND_SZ支持解析环境变量占位符（如%PATH%）
        winreg.SetValueEx(key, var_name, 0, winreg.REG_EXPAND_SZ, var_value)
    # 发送系统通知，让新打开的进程能读取到更新后的环境变量
    HWND_BROADCAST = 0xFFFF
    WM_SETTINGCHANGE = 0x1A
    SMTO_ABORTIFHUNG = 0x0002
    result = ctypes.c_long()
    ctypes.windll.user32.SendMessageTimeoutW(
        HWND_BROADCAST, WM_SETTINGCHANGE, 0, 'Environment',
        SMTO_ABORTIFHUNG, 5000, ctypes.byref(result)
    )

# 调用示例
set_user_env_var('USER', 'username')

2. 设置系统级环境变量（需管理员权限）

import winreg
import ctypes

def set_system_env_var(var_name, var_value):
    # 打开系统环境变量对应的注册表项，需管理员权限
    with winreg.OpenKey(winreg.HKEY_LOCAL_MACHINE, r'SYSTEM\CurrentControlSet\Control\Session Manager\Environment', 0, winreg.KEY_SET_VALUE) as key:
        winreg.SetValueEx(key, var_name, 0, winreg.REG_EXPAND_SZ, var_value)
    # 发送系统通知更新环境变量缓存
    HWND_BROADCAST = 0xFFFF
    WM_SETTINGCHANGE = 0x1A
    SMTO_ABORTIFHUNG = 0x0002
    result = ctypes.c_long()
    ctypes.windll.user32.SendMessageTimeoutW(
        HWND_BROADCAST, WM_SETTINGCHANGE, 0, 'Environment',
        SMTO_ABORTIFHUNG, 5000, ctypes.byref(result)
    )

# 调用示例（需以管理员身份运行Python脚本）
set_system_env_var('USER', 'username')

注意事项 #

• 修改系统级环境变量必须以管理员身份运行脚本，否则会触发权限错误。
• 发送WM_SETTINGCHANGE消息仅能让新启动的进程读取到新变量，已运行的进程需要重启才能生效。
• 如果修改的是PATH这类路径集合变量，建议先读取原有值再拼接新路径，避免覆盖原有配置。

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