.NET Core控制台应用如何按指定配置文件发布并实现配置转换？

一、Visual Studio发布时指定Console.PRD配置文件 #

Visual Studio右键项目选「Publish」默认没配置文件选择入口，可按以下方式设置：

• 右键项目 → 发布 → 点击现有发布配置旁的「编辑」按钮（也可直接新建发布配置）
• 在发布配置编辑器的「设置」标签页中，找到「配置」下拉框，选择对应的Console.PRD（若未找到，先去项目属性的「调试」标签页确认配置文件已创建，重启VS即可刷新出来）
• 若嫌操作繁琐，可直接编辑项目根目录Properties/PublishProfiles下的.pubxml文件，添加以下配置：

<PropertyGroup>
  <EnvironmentName>PRD</EnvironmentName>
</PropertyGroup>

保存后重新发布，即可按PRD环境的配置部署。

二、实现类似SlowCheetah的appsettings.json配置转换 #

.NET Core默认采用叠加加载配置：先读取主appsettings.json，再读取对应环境的appsettings.{env}.json，后者覆盖前者的相同键，但发布时不会自动将环境配置合并到主文件中。要实现像SlowCheetah那样的替换/合并效果，提供两种常用方案：

方案1：使用MSBuild原生TransformXml任务 #

1. 打开项目文件（.csproj），添加以下配置启用转换：

<ItemGroup>
  <!-- 确保主配置和环境配置都复制到输出目录 -->
  <None Include="appsettings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
  <None Include="appsettings.*.json">
    <DependentUpon>appsettings.json</DependentUpon>
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

<!-- 引入TransformXml任务 -->
<UsingTask TaskName="TransformXml" AssemblyFile="$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v$(VisualStudioVersion)\Web\Microsoft.Web.Publishing.Tasks.dll" />

<!-- 发布后执行配置转换 -->
<Target Name="TransformAppSettings" AfterTargets="Publish">
  <TransformXml Source="$(ProjectDir)appsettings.json"
                Transform="$(ProjectDir)appsettings.$(EnvironmentName).json"
                Destination="$(PublishDir)appsettings.json" />
</Target>

2. 发布时用命令行指定环境：dotnet publish --configuration Release --environment PRD，或在Visual Studio发布配置中设置好EnvironmentName，发布后主appsettings.json会被环境配置替换合并。

方案2：使用SlowCheetah工具（贴合传统app.config转换习惯） #

1. 打开Visual Studio扩展市场，安装「SlowCheetah - XML Transforms」
2. 右键项目中的appsettings.json → 「Add Transform」，自动生成对应配置文件的转换文件（如appsettings.PRD.json）
3. 编辑转换文件，用XDT语法编写转换规则，例如替换AppSettings.env的值：

<AppSettings>
  <env value="PRD" xdt:Transform="SetAttributes" xdt:Locator="Match(value)" />
</AppSettings>

4. 安装扩展后项目文件会自动添加SlowCheetah的配置，发布时会自动执行转换，生成合并后的appsettings.json。

补充：若无需合并，保留多配置文件运行时加载 #

如果不需要合并主文件，仅想在运行时自动加载对应环境的配置，确保代码中按以下方式编写：

var env = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Production";
var config = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings.{env}.json", optional: true, reloadOnChange: true)
    .Build();

发布时将所有appsettings.*.json复制到发布目录，运行时会根据环境变量自动加载对应配置。

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