.NET Core 2.0多环境Appsettings配置：能否实现文件转换替代参数指定

嘿，我之前在处理多环境配置合并的时候也折腾过这个需求，除了用环境变量触发配置加载，还有这几个实用的方法可以把特定环境的配置合并到appsettings.json里：

1. 用MSBuild的TransformXml任务实现编译时转换 #

这是.NET生态里原生支持的方案，适合在项目构建阶段直接完成配置合并。你只需要在项目文件（.csproj）里添加对应的MSBuild任务，指定基础配置文件和环境特定的转换文件，构建时就能自动把差异合并到目标文件中。

举个配置示例，在你的.csproj里加入这段：

<Target Name="TransformAppSettings" AfterTargets="Build">
  <PropertyGroup>
    <!-- 这里可以通过构建参数传入环境名称，比如Development/Staging/Production -->
    <Environment Condition="'$(Environment)' == ''">Development</Environment>
    <SourceFile>appsettings.json</SourceFile>
    <TransformFile>appsettings.$(Environment).json</TransformFile>
    <DestinationFile>$(OutputPath)appsettings.json</DestinationFile>
  </PropertyGroup>
  <TransformXml Source="$(SourceFile)" Transform="$(TransformFile)" Destination="$(DestinationFile)" />
</Target>

构建的时候只需要传入环境参数就行：

dotnet build -p:Environment=Staging

这样构建输出目录里的appsettings.json就是合并了appsettings.Staging.json后的结果。

2. 写自定义脚本实现配置合并（PowerShell/C#） #

如果需要更灵活的合并逻辑（比如处理复杂的嵌套节点、数组合并），可以写个简单的脚本。比如用PowerShell，就能轻松完成JSON的读取、合并和写入：

下面是一个PowerShell脚本示例（命名为Merge-AppSettings.ps1）：

param(
    [string]$Environment = "Development"
)

# 读取基础配置和环境配置
$baseConfig = Get-Content "appsettings.json" | ConvertFrom-Json
$envConfig = Get-Content "appsettings.$Environment.json" | ConvertFrom-Json

# 递归合并配置节点
function Merge-Objects($base, $override) {
    foreach ($prop in $override.PSObject.Properties) {
        if ($base.PSObject.Properties[$prop.Name] -and $base.$($prop.Name) -is [PSObject]) {
            Merge-Objects $base.$($prop.Name) $prop.Value
        } else {
            $base | Add-Member -MemberType NoteProperty -Name $prop.Name -Value $prop.Value -Force
        }
    }
    return $base
}

$mergedConfig = Merge-Objects $baseConfig $envConfig

# 将合并后的结果写回appsettings.json
$mergedConfig | ConvertTo-Json -Depth 100 | Set-Content "appsettings.json"

使用的时候直接指定环境运行脚本：

.\Merge-AppSettings.ps1 -Environment Production

这个脚本会把环境配置里的节点覆盖或合并到基础的appsettings.json中，适合本地开发或者CI/CD流程里调用。

3. 在CI/CD流程中用内置工具实现转换 #

如果你的项目是通过CI/CD流水线构建部署的，大部分主流工具都有内置的配置转换功能，不需要自己写脚本：

• Azure DevOps：用「File Transform」任务，选择源文件为appsettings.json，转换文件为appsettings.$(Environment).json，流水线运行时指定环境变量就能自动完成合并。
• GitHub Actions：可以用第三方action或者自己结合PowerShell脚本步骤来实现。
• Jenkins：通过插件或者执行Shell/PowerShell脚本的方式，调用前面提到的合并逻辑。

这些工具的好处是可以把配置合并和构建部署流程无缝整合，不需要在本地额外操作。

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