如何在ASP.NET Core中用自定义内容合并自动生成的web.config文件？

方案1：直接使用自定义web.config模板（最省心） #

如果不需要保留自动生成的web.config内容，直接自定义完整配置文件替代自动生成逻辑：

• 在项目根目录创建web.config，写入所有IIS相关自定义配置（比如system.webServer下的重写规则、自定义头、模块设置等）
• 编辑项目的.csproj文件，添加以下配置禁用自动生成：

<PropertyGroup>
  <!-- 指定使用自定义的web.config文件 -->
  <WebConfigFileName>web.config</WebConfigFileName>
  <!-- 关闭自动生成web.config的功能 -->
  <GenerateWebConfig>false</GenerateWebConfig>
</PropertyGroup>

发布时系统会直接复制你编写的web.config，完全跳过自动生成流程。

方案2：用共享转换文件避免重复配置 #

如果需要保留自动生成的基础配置，仅添加通用自定义规则，可通过共享文件减少重复劳动：

• 新建web.Base.config文件，写入通用转换规则：

<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <!-- 示例：添加自定义HTTP响应头 -->
  <system.webServer>
    <httpProtocol xdt:Transform="InsertIfMissing">
      <customHeaders xdt:Transform="InsertIfMissing">
        <add name="X-App-Version" value="1.0.0" xdt:Locator="Match(name)" xdt:Transform="InsertIfMissing" />
      </customHeaders>
    </httpProtocol>
    <!-- 示例：添加URL重写规则 -->
    <rewrite xdt:Transform="InsertIfMissing">
      <rules>
        <rule name="LegacyPathRewrite" stopProcessing="true" xdt:Transform="InsertIfMissing">
          <match url="^old/(.*)" />
          <action type="Rewrite" url="new/{R:1}" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

• 编辑web.Debug.config和web.Release.config，引入共享文件即可，无需重复编写相同规则：

<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <!-- 引入通用转换规则 -->
  <xdt:Import path="web.Base.config" />
  <!-- 若有环境特定配置，可在此单独添加 -->
</configuration>

方案3：通过.csproj直接注入配置 #

如果仅需添加少量简单配置节点，无需额外转换文件，直接在.csproj中配置自动合并：

<ItemGroup>
  <WebConfigTransformation Include="
    <system.webServer>
      <security xdt:Transform="InsertIfMissing">
        <requestFiltering xdt:Transform="InsertIfMissing">
          <hiddenSegments xdt:Transform="InsertIfMissing">
            <add segment="internal-resources" xdt:Locator="Match(segment)" xdt:Transform="InsertIfMissing" />
          </hiddenSegments>
        </requestFiltering>
      </security>
    </system.webServer>" />
</ItemGroup>

这段配置会在自动生成web.config时，自动将指定节点合并到对应位置。

转换失败排查提示 #

如果之前使用官方转换方法未成功，大概率是转换语法错误：

• 确保使用正确的xdt:Transform属性：新增节点用InsertIfMissing，替换现有节点用Replace，匹配节点需配合xdt:Locator
• 检查命名空间：所有转换文件必须包含xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform"

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