如何为不同IIS部署目标使用对应的appsettings.json文件？

一、ASP.NET Core 场景 #

方案1：用发布配置文件（.pubxml）直接替换文件 #

这完全匹配你“部署时将对应配置替换为appsettings.json”的需求，操作步骤：

1. 项目中创建appsettings.site1.json和appsettings.site2.json，右键文件→属性，设置「复制到输出目录」为「如果较新则复制」。
2. 在Properties/PublishProfiles目录下，创建对应发布目标的.pubxml文件（比如Site1.pubxml、Site2.pubxml）。
3. 在每个.pubxml里添加替换规则，两种方式任选：
   • 方式A（用MSDeploy替换规则）：

     <Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
       <PropertyGroup>
         <!-- 保留原有发布配置，比如发布路径、方法等 -->
       </PropertyGroup>
       <ItemGroup>
         <MsDeployReplaceRules Include="ReplaceAppSettings">
           <ObjectName>filePath</ObjectName>
           <Match>appsettings.json</Match>
           <ReplaceWith>appsettings.site1.json</ReplaceWith>
         </MsDeployReplaceRules>
       </ItemGroup>
     </Project>
     

   • 方式B（发布后复制覆盖）：

     <Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
       <PropertyGroup>
         <!-- 保留原有发布配置 -->
       </PropertyGroup>
       <Target Name="OverrideAppSettings" AfterTargets="Publish">
         <Copy 
           SourceFiles="$(ProjectDir)appsettings.site1.json" 
           DestinationFiles="$(PublishDir)appsettings.json" 
           OverwriteReadOnlyFiles="true" 
         />
       </Target>
     </Project>
     

4. 发布时选择对应的.pubxml配置，即可自动完成文件替换。

方案2：用Core内置环境配置（无需替换文件） #

如果可以接受“加载对应环境配置而非替换文件”，这是更符合Core设计的方案：

• ASP.NET Core会自动加载appsettings.json + appsettings.{环境名}.json，后者的配置会覆盖前者。
• 部署时，在IIS中设置环境变量ASPNETCORE_ENVIRONMENT为Site1或Site2：
  1. 打开IIS管理器→选中站点→右键「高级设置」→添加环境变量。
  2. 或者修改站点的web.config：

     <aspNetCore processPath="dotnet" arguments=".\YourApp.dll">
       <environmentVariables>
         <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Site1" />
       </environmentVariables>
     </aspNetCore>
     

• 启动应用后，系统会自动加载appsettings.Site1.json的配置，无需替换原appsettings.json。

二、传统ASP.NET MVC 场景 #

方案1：发布配置文件替换json #

和Core的.pubxml方式一致，在对应发布配置文件中添加发布后复制覆盖的Target，把appsettings.site1.json复制为appsettings.json。

方案2：Web.config转换（针对Web.config中的配置） #

如果你的配置是存在Web.config的appSettings节点中，推荐用Web.config转换：

1. 创建Web.Site1.config和Web.Site2.config转换文件。
2. 在转换文件中定义替换规则，比如：

   <?xml version="1.0"?>
   <configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
     <appSettings>
       <add key="ConnectionString" value="Site1专属连接串" xdt:Transform="SetAttributes" xdt:Locator="Match(key)" />
     </appSettings>
   </configuration>
   

3. 发布时选择对应配置目标，自动完成Web.config的配置替换。

三、各方式对比 #

• 发布配置文件（.pubxml）：完全满足你“替换appsettings.json”的需求，适配Core和MVC，操作直接。
• 环境变量（Core）：无需替换文件，更符合Core的配置设计，适合不需要物理替换文件的场景。
• Web.config转换：仅适合传统MVC的Web.config配置，不推荐用于Core的appsettings.json。

内容的提问来源于stack exchange，提问作者Mehmet Aydın