dotnet core 3.1项目使用dotnet publish时如何排除web.config文件

原有配置不生效的核心原因 #

你之前尝试的几类Content项配置完全没踩到点子上，核心是Web SDK的发布流程设计决定的：

• 所有针对web.config的Remove/CopyToPublishDirectory=Never标记，作用范围仅限于项目目录下已经存在的静态web.config文件
• 但.NET Core 3.1使用的Web SDK（Microsoft.NET.Sdk.Web）内置了独立的_TransformWebConfig发布目标任务，这个任务会在所有常规文件拷贝动作全部完成后，自动从头生成一份全新的web.config，直接写入发布输出目录。
• 这个生成逻辑完全独立于项目内的Content文件收集规则，不管你怎么标记要排除已有的静态web.config，这个自动生成动作都会把新文件写到输出目录，之前的所有配置根本碰不到这个环节。
• 这个自动生成的web.config默认会在托管配置块中追加本地开发环境的ASPNETCORE_ENVIRONMENT=Development值，正好对应你遇到的覆盖Staging/Production环境变量的异常问题。

正确排除web.config的实现方式 #

要从根源上把web.config从发布产物里踢出去，根本不需要反复调整Content项的标记，直接用SDK内置的开关禁用web.config生成流程就行：

1. 打开项目的.csproj文件，在任意<PropertyGroup>节点下加入配置：

<PropertyGroup>
  <!-- 完全禁用web.config的生成、转换、写入发布目录的内置流程 -->
  <IsWebConfigTransformDisabled>true</IsWebConfigTransformDisabled>
</PropertyGroup>

2. 重新执行dotnet publish就能验证：输出目录不会再出现自动生成的web.config文件，也不会再出现强制写入的Development环境变量覆盖问题。

适配Azure部署的补充说明 #

• 这套配置和Azure App Service的托管逻辑完全兼容：Azure会自动识别.NET Core应用的进程运行需求，所有环境变量、托管参数直接通过应用服务的配置面板统一管理即可，不需要依赖web.config传递配置。
• 该配置不影响本地IIS调试：本地通过IIS Express或IIS运行应用时，SDK会在临时运行目录生成必要的web.config完成进程托管，不会因为禁用发布期的web.config生成流程，打断本地开发调试。

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