使用ConfigurationBuilder时如何将大写蛇形环境变量映射为帕斯卡属性

方案1：使用ConfigurationKeyName特性（最便捷，.NET Core 3.0+支持） #

直接给TOptions的属性标记特性，指定对应的环境变量名即可，不需要修改原有配置注册逻辑：

public class MyOptions
{
    [ConfigurationKeyName("MY_FIRST_VAR")]
    public int MyFirstVar { get; set; }
    [ConfigurationKeyName("MY_SECOND_VAR")]
    public string MySecondVar { get; set; }
}

该方案适合属性数量较少的场景，原有Configure<TOptions>的代码无需任何改动即可正常绑定。

方案2：自定义配置键名转换器（适合属性多，.NET 7+支持） #

如果TOptions属性数量多，逐个加特性效率低，可以全局配置环境变量提供器的键名转换逻辑，自动实现大写蛇形命名到帕斯卡命名的映射：

1. 首先实现键名转换器：

using Microsoft.Extensions.Configuration;
using System.Globalization;

public class UpperSnakeCaseToPascalConverter : IConfigurationKeyNameConverter
{
    public string Convert(string key)
    {
        // 纯手写无正则的转换逻辑，性能更优
        var parts = key.Split('_', StringSplitOptions.RemoveEmptyEntries);
        return string.Join("", parts.Select(p => 
            char.ToUpper(p[0], CultureInfo.InvariantCulture) + p[1..].ToLower(CultureInfo.InvariantCulture)));
    }
}

2. 注册环境变量配置源时指定转换器：

var builder = new ConfigurationBuilder();
builder.AddEnvironmentVariables(options => 
{
    options.KeyNameConverter = new UpperSnakeCaseToPascalConverter();
});
// 后续Configure<TOptions>逻辑保持不变，属性直接用帕斯卡命名即可正常绑定

方案3：手动绑定配置（全版本兼容） #

如果使用的.NET版本低于3.0，不支持上述特性和转换器，可以直接在配置Options阶段手动读取环境变量赋值：

builder.Services.Configure<MyOptions>(opt =>
{
    opt.MyFirstVar = builder.Configuration.GetValue<int>("MY_FIRST_VAR");
    opt.MySecondVar = builder.Configuration.GetValue<string>("MY_SECOND_VAR");
});

该方案不依赖任何高版本API，所有.NET Core/.NET 5+版本都可以正常运行。

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