.NET Core多环境配置问询：开发/预发布/生产共用源码

Hey，我之前在把.NET Core项目部署到Azure的时候，也碰到过和你一模一样的配置加载问题，折腾了好一阵才搞定，给你几个亲测有效的解决方案：

1. 先确认Azure应用服务的环境变量设置 #

本地的ASPNETCORE_ENVIRONMENT环境变量Azure是不会自动继承的，你得手动在Azure门户里配置：

• 登录Azure门户，找到你的目标应用服务
• 进入配置 > 应用程序设置页面
• 点击「新建应用程序设置」，添加名为ASPNETCORE_ENVIRONMENT的项，值设为Staging或Production（根据你的部署环境需求）
• 保存设置后记得重启应用服务，这样应用启动时就会自动加载对应的appsettings.{Environment}.json文件了

2. 确保所有配置文件都被包含在发布包中 #

有时候发布到Azure时，非默认的环境配置文件会被漏掉，这时候要检查你的项目文件（.csproj）：

• 打开项目文件，添加或确认以下配置，确保所有环境的配置文件都会被复制到发布目录：

<ItemGroup>
  <Content Include="appsettings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  </Content>
  <Content Include="appsettings.Development.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  </Content>
  <Content Include="appsettings.Staging.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  </Content>
  <Content Include="appsettings.Production.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  </Content>
</ItemGroup>

保存后重新发布，所有配置文件就会跟着一起传到Azure服务器了。

3. 进阶方案：用Azure应用配置替代文件配置 #

如果觉得维护多个配置文件太麻烦，强烈推荐用Azure的应用配置服务，这也是现在微软官方推荐的方式：

• 先在Azure门户创建一个「应用配置」实例
• 在实例里按环境（比如Development/Staging/Production）分组配置键值对，给每个配置项打上对应的环境标签
• 在项目中安装Microsoft.Azure.AppConfiguration.AspNetCore NuGet包
• 修改Program.cs，让应用从Azure应用配置加载对应环境的配置：

var builder = WebApplication.CreateBuilder(args);
var env = builder.Environment;

// 从环境变量读取Azure应用配置的连接字符串
var connectionString = Environment.GetEnvironmentVariable("AzureAppConfigurationConnectionString");

builder.Configuration.AddAzureAppConfiguration(options =>
{
    options.Connect(connectionString)
           // 加载当前环境标签下的所有配置
           .Select(KeyFilter.Any, LabelFilter.Equals(env.EnvironmentName));
});

这种方式不需要再管理本地的配置文件，直接在Azure门户里维护不同环境的配置，既灵活又安全，还能随时修改配置而不需要重新发布应用。

4. 检查Visual Studio发布配置（如果用VS发布） #

如果你是用Visual Studio直接发布到Azure，要确认你的发布配置文件（.pubxml）没有硬编码环境变量：

• 打开发布配置文件，确保EnvironmentName是动态读取的，而不是固定值：

<PropertyGroup>
  <EnvironmentName>$(ASPNETCORE_ENVIRONMENT)</EnvironmentName>
</PropertyGroup>

这样发布时就会使用你在Azure门户设置的环境变量，而不会强制覆盖成某个固定环境。

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