.NET7中如何将appsettings与环境变量绑定到同一IOptions模型

针对你的需求，不用拆分模型，有两种简单的实现方式，适合刚接触.NET的新手：

方式一：手动绑定指定环境变量 #

如果你的环境变量直接叫TestNumber（没有前缀），可以在原有绑定逻辑后，用Configure方法手动读取环境变量并赋值：

builder.Services
    .AddOptions<MyOptions>()
    .Bind(config.GetSection(MyOptions.SectionName)) // 先绑定appsettings里的MySettings节（Address属性）
    .Configure(options =>
    {
        // 读取环境变量"TestNumber"，转成int类型后赋值给TestNumber属性
        if (int.TryParse(Environment.GetEnvironmentVariable("TestNumber"), out var testNum))
        {
            options.TestNumber = testNum;
        }
    })
    .ValidateOnStart();

说明： #

• Environment.GetEnvironmentVariable("TestNumber")：直接获取系统环境变量里名为TestNumber的值
• int.TryParse：避免环境变量不存在或者不是数字时程序报错，如果要求这个环境变量必须存在，可以换成int.Parse（但不存在时会抛出异常）
• 这个方法的好处是不用改环境变量的命名，直接用现有变量名就行

方式二：遵循.NET配置规范自动绑定 #

如果可以控制环境变量的命名，推荐用这种更规范的方式：把环境变量命名为MySettings__TestNumber（双下划线分隔配置节和属性名），这样不用改原有代码，.NET会自动合并配置。

为什么这么命名？ #

.NET的配置系统默认已经包含环境变量作为配置源，它会自动把格式为[配置节名称]__[属性名]的环境变量，映射到对应Options模型的属性上。比如你的配置节是MySettings，属性是TestNumber，环境变量名就用MySettings__TestNumber，原有代码：

builder.Services
    .AddOptions<MyOptions>()
    .Bind(config.GetSection(MyOptions.SectionName))
    .ValidateOnStart();

就会自动把appsettings里的Address和环境变量里的TestNumber合并到同一个MyOptions对象里，完全不用额外代码。

验证小技巧 #

可以在程序里注入IOptions<MyOptions>，然后输出两个属性的值，确认是否绑定成功：

app.MapGet("/test", (IOptions<MyOptions> options) =>
{
    return new { Address = options.Value.Address, TestNumber = options.Value.TestNumber };
});

启动程序后访问/test，就能看到两个配置项的值了。

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