如何在.NET运行时应用多个环境配置文件

我来给你唠唠怎么在.NET微服务里实现多环境配置文件的叠加覆盖，正好我之前做项目的时候也折腾过类似的需求，踩过的坑给你避避😎

首先你得知道，.NET Core 3.1及以后的版本已经原生支持指定多个环境名称了，不用写复杂的自定义代码就能实现你的需求。核心思路就是：把你想叠加的环境用逗号分隔，按你要的优先级顺序排列，后面的环境配置会覆盖前面的同名配置项。

一、命令行启动时直接指定多个环境 #

这是最直接的方式，比如你想先加载Development的默认配置，再用Hsqldb的DB配置覆盖它，直接在命令行里这么写：

dotnet run --environment "Development,Hsqldb"

或者如果是发布后的程序：

dotnet YourService.dll --environment "Development,Hsqldb"

这里要注意顺序！后面的环境配置优先级更高，比如appsettings.Hsqldb.json里的DB连接字符串会直接替换appsettings.Development.json里的对应项，其他没冲突的配置则会保留Development里的内容。

二、在launchSettings.json里配置（适合本地调试） #

如果你习惯用VS或者Rider本地F5启动，直接改launchSettings.json就行：
找到你项目对应的profile，修改environmentVariables里的环境变量——如果是ASP.NET Core项目，就改ASPNETCORE_ENVIRONMENT；如果是普通.NET控制台/微服务，就改DOTNET_ENVIRONMENT，把值设为你的多环境列表：

{
  "profiles": {
    "YourMicroservice": {
      "commandName": "Project",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development,Hsqldb"
      }
    }
  }
}

改完之后，下次F5启动就会自动按顺序加载这两个配置文件了，调试起来特别方便。

三、配置加载的优先级规则 #

给你明确一下加载顺序，避免搞混：

• 基础配置appsettings.json（最先加载，优先级最低）
• 按你指定的环境顺序加载对应的配置文件：appsettings.Development.json → appsettings.Hsqldb.json（后面的覆盖前面的）
• 最后还会加载环境变量、命令行参数这些（优先级最高，不过这部分是.NET默认行为，你不用改）

四、特殊场景：手动加载配置（备选方案） #

如果你的需求更复杂，比如需要根据动态条件加载不同的配置，也可以在Program.cs里手动指定加载顺序：

var builder = WebApplication.CreateBuilder(args);

// 自定义环境列表，按你要的顺序来
var targetEnvironments = new[] { "Development", "Hsqldb" };
foreach (var env in targetEnvironments)
{
    // 加载对应环境的配置文件，optional: true表示文件不存在也不会报错
    builder.Configuration.AddJsonFile(
        $"appsettings.{env}.json",
        optional: true,
        reloadOnChange: true
    );
}

// 剩下的正常构建应用
var app = builder.Build();
// ...

不过我还是推荐用前面的多环境变量方式，更符合.NET的原生设计，也更简洁。

举个你的例子：appsettings.Development.json里有本地开发的默认配置，appsettings.Hsqldb.json里只放DB相关的覆盖配置，运行时指定Development,Hsqldb，这样既保留了本地开发的其他配置，又把DB换成了Hsqldb的配置，完美匹配你的需求！

备注：内容来源于stack exchange，提问作者Nickknack