如何创建优先读取环境变量、未找到则用appsettings的ConfigurationBuilder？

嘿，我来帮你搞定这个配置优先级的问题！在ASP.NET Core里，ConfigurationBuilder的配置源添加顺序直接决定了优先级——后添加的配置源会覆盖先添加的同名配置项。所以要实现「环境变量找不到才用appsettings里的配置」，我们只需要调整配置源的添加顺序即可。

修改后的完整代码 #

public void ConfigureServices(IServiceCollection services)
{
    // 获取当前环境名称，默认兜底为Production
    var environmentName = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production";

    // 构建配置，确保环境变量优先级高于appsettings
    var configuration = new ConfigurationBuilder()
        .SetBasePath(Directory.GetCurrentDirectory())
        // 先添加通用appsettings（基础配置，必须存在）
        .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
        // 再添加对应环境的专属appsettings（可选，会覆盖通用配置）
        .AddJsonFile($"appsettings.{environmentName}.json", optional: true, reloadOnChange: true)
        // 最后添加环境变量（优先级最高，覆盖所有前置配置）
        .AddEnvironmentVariables()
        .Build();

    // 将配置注入服务容器，方便后续使用
    services.AddSingleton<IConfiguration>(configuration);

    // 你的其他服务配置代码...
}

关键细节说明 #

• 顺序是核心逻辑：先加载JSON配置文件作为基础，最后加载环境变量。这样如果环境变量存在同名配置，会直接覆盖JSON里的值；如果环境变量没有对应项，就自动沿用JSON文件的内容，完全匹配你的需求。
• 环境专属配置优化：额外加入了appsettings.{environmentName}.json，这是ASP.NET Core的常规实践——可以针对开发、测试、生产等不同环境维护专属配置，它会覆盖通用appsettings.json的同名项，同时又会被环境变量覆盖。
• 层级配置的环境变量写法：如果你的appsettings里有层级结构（比如ConnectionStrings:DefaultConnection），对应的环境变量需要用**双下划线__**代替冒号，写成ConnectionStrings__DefaultConnection，这样ConfigurationBuilder才能正确识别并匹配。

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