当前会话临时变量#

1
$env:API_KEY = "test-value"
2
python -c "import os; print(os.getenv('API_KEY'))"

这种写法只对当前 PowerShell 窗口和它启动的子进程有效。关闭窗口后就没了。

持久用户变量#

1
[Environment]::SetEnvironmentVariable("API_KEY", "test-value", "User")

设置后通常需要重新打开终端，已经运行的程序不会自动拿到新值。

查看变量#

1
Get-ChildItem Env:
2
$env:PATH -split ';'

常见问题#

• 在一个终端设置变量，却在另一个已经打开的终端运行程序。

• 变量名大小写混用，跨平台时表现不同。

• 把值写进命令历史，泄露敏感信息。

• 修改 PATH 后没有重新打开终端。

实战复盘#

把《PowerShell 环境变量设置》写成可复用排查记录时，我会保留四类证据：原始现象、执行命令、关键输出、修复后的验证结果。少了其中任何一类，下次遇到类似问题都容易重新猜一遍。

排查类文章不要只写最终命令，还要写为什么先查这里。比如端口问题先看监听进程，Nginx 问题先分清 404 和 403，Python 环境问题先确认解释器路径。

如果修复动作有风险，例如杀进程、删文件、改服务配置，就应该写清回退方式。能恢复，才敢在服务器上操作。

最小验收样例#

验收《PowerShell 环境变量设置》时，我会保留一条修复前命令和一条修复后命令。前者证明问题存在，后者证明问题已经消失，而不是只凭浏览器或终端感觉判断。

如果这篇文章涉及服务器操作，还要记录当前路径、用户、服务名和关键配置文件。排查记录越能还原现场，下次遇到同类问题越不需要重新摸索。

小结#

PowerShell 环境变量要区分临时和持久，也要记住进程边界。程序读不到变量时，先在同一个终端里打印确认。