C# 环境变量读取方法 C#如何获取系统环境变量

来源：这里教程网时间：2026-02-21 17:40:34 作者：

直接用

Environment.GetEnvironmentVariable

读单个变量

这是最常用、最轻量的方式，适合明确知道变量名的场景。它默认只查当前进程的环境变量快照，不实时刷新系统级变更。

Environment.GetEnvironmentVariable("PATH")
返回字符串，变量不存在时返回
null
第二个参数可指定作用域：
EnvironmentVariableTarget.Machine
（读注册表 HKEY_LOCAL_MACHINE）或
EnvironmentVariableTarget.User
（HKEY_CURRENT_USER），但需注意：.NET Core / .NET 5+ 在非 Windows 平台不支持后两者，会抛
PlatformNotSupportedException
Windows 上读取
Machine
级变量需要管理员权限，否则静默返回
null
，不是权限错误提示

用

Environment.GetEnvironmentVariables

批量读取全部变量

IDictionary

，键为变量名（全大写，Windows 下不区分大小写但返回值统一为大写），值为字符串。适用于调试、配置探测等需要遍历的场景。

无参调用只返回当前进程环境块副本，不含新近由其他进程设置的全局变量 传入
EnvironmentVariableTarget.Process
效果相同；传
Machine
或
User
同样受平台和权限限制在容器（如 Linux Docker）中运行时，该方法仅反映容器启动时注入的环境，不包含运行时
export
的新变量

读不到刚设置的系统变量？注意进程继承机制

Windows 和 Linux 都不会自动将新设的系统级环境变量“推”给已运行的进程。C# 程序启动时从父进程（如终端、IDE、服务管理器）继承环境快照，之后独立存在。

修改注册表或
/etc/environment
后，必须重启你的 C# 进程（不是重新编译，是彻底关闭再启动）在 PowerShell 中执行
$env:FOO="bar"
只影响该 Shell 及其子进程，不影响已运行的 dotnet 进程验证是否生效：用
Process.Start("cmd", "/c set")
启动新 cmd 查看实际环境，比依赖 IDE 的调试环境更可靠

.NET 6+ 推荐用

IConfiguration

统一管理，而非硬编码读取

如果变量用于配置（如数据库连接串、API 密钥），直接调

GetEnvironmentVariable

容易散落各处、难测试、无法 fallback。应交由配置系统接管。

var builder = new ConfigurationBuilder()
    .AddEnvironmentVariables(); // 自动加载所有环境变量
var config = builder.Build();
<p>string dbConn = config["ConnectionStrings:Default"]; // 按前缀映射
string logLevel = config["Logging:LogLevel:Default"] ?? "Information";</p>

AddEnvironmentVariables()
默认只加载以
DOTNET_
、
ASPNETCORE_
开头的变量（.NET 6+ 行为），如需加载全部，传入空字符串：
AddEnvironmentVariables("")
变量名中的双下划线
__
会被转为配置层级分隔符，例如
LOGGING__LOGLEVEL__DEFAULT
→
Logging:LogLevel:Default
这样写的好处：可与 JSON、命令行参数等其他源合并，支持热重载（
reloadOnChange: true
），单元测试时容易 Mock

环境变量不是实时广播信道，而是进程启动时的一次性快照。真正要动态响应变化，得自己监听文件、注册表或信号，而不是指望