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

最常用方式是直接调用Environment.GetEnvironmentVariable读单个变量，它返回字符串或null，支持指定作用域但受平台和权限限制；批量读取用GetEnvironmentVariables；.NET 6+推荐通过IConfiguration统一管理以支持多源合并、热重载和测试。

直接用 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();
string dbConn = config["ConnectionStrings:Default"]; // 按前缀映射
string logLevel = config["Logging:LogLevel:Default"] ?? "Information";

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

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