.NET 6项目如何从Windows环境变量读取配置值？

针对你遇到的无法读取Windows环境变量ClusterSettings__Password的问题，按以下步骤排查修复：

1. 修正代码中的变量拼写错误 #

你提供的绑定代码里存在变量名不一致的问题：

Conf = new Settings();
Configuration = builder.Build();
Configuration.Bind(Config); // 此处变量名应为Conf而非Config

将Configuration.Bind(Config);修改为Configuration.Bind(Conf);，确保配置绑定到正确的Settings实例上。

2. 确保环境变量生效 #

Windows环境变量设置后，必须重启运行应用的终端或IDE（如Visual Studio），因为进程仅在启动时加载环境变量，不重启的话新设置的变量无法被读取。
可在命令行执行echo %ClusterSettings__Password%，验证变量是否能正常输出。

3. 确认配置源优先级 #

.NET 6默认配置加载顺序中，环境变量优先级高于appsettings.json，但如果自定义过配置源顺序，需保证环境变量源在json配置之后加载。默认配置构建代码示例：

var builder = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings.{Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production"}.json", optional: true)
    .AddEnvironmentVariables(); // 此步骤需在json配置之后，才能补充/覆盖json配置

确保AddEnvironmentVariables()被正确调用，且顺序在json配置之后。

4. 改用强类型配置注入（推荐） #

.NET 6更推荐通过依赖注入获取配置，替代手动绑定：
在Program.cs中添加：

builder.Services.Configure<Settings>(builder.Configuration);

然后在需要使用配置的类中，通过构造函数注入IOptions<Settings>：

public class YourService
{
    private readonly Settings _settings;

    public YourService(IOptions<Settings> settings)
    {
        _settings = settings.Value;
        // 使用 _settings.ClusterSettings.Password 即可获取值
    }
}

这种方式更符合.NET 6最佳实践，也更可靠。

5. 验证环境变量命名格式 #

确认环境变量名称为ClusterSettings__Password（双下划线分隔层级），Windows环境变量不区分大小写，但需保证拼写完全正确，无多余或缺失字符。

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