Visual Studio发布.NET Framework站点生成文件少于构建问题

问题描述 #

• 使用Visual Studio 2022的发布功能（发布到文件夹或IIS）部署.NET Framework站点时，发现与Release构建输出相比，发布包缺少部分文件：
  • Content目录下的*.css文件缺失，导致站点样式失效
  • 部分.cs类文件未出现在发布包中，但站点运行未受影响
• 疑问：发布操作的具体作用是什么？是否仅复制构建生成的文件？

发布配置（发布到文件夹） #

<Project>
  <PropertyGroup>
    <DeleteExistingFiles>false</DeleteExistingFiles>
    <ExcludeApp_Data>false</ExcludeApp_Data>
    <LaunchSiteAfterPublish>true</LaunchSiteAfterPublish>
    <LastUsedBuildConfiguration>Release</LastUsedBuildConfiguration>
    <LastUsedPlatform>Any CPU</LastUsedPlatform>
    <PublishProvider>FileSystem</PublishProvider>
    <PublishUrl>bin\app.publish\</PublishUrl>
    <WebPublishMethod>FileSystem</WebPublishMethod>
    <_TargetId>Folder</_TargetId>
  </PropertyGroup>
</Project>

解答 #

发布的核心作用 #

发布是将应用程序打包为可直接部署到目标环境的完整运行包，并非简单复制构建文件——它会先执行指定配置（此处为Release）的构建，再根据发布规则筛选、整理运行必需的文件，排除不必要的源文件、临时文件等。

针对问题的具体说明 #

1. .cs类文件缺失是正常现象
   .NET Framework项目在Release构建时，所有.cs源文件会被编译为*.dll或*.exe程序集，发布时仅会复制编译后的程序集文件，不会保留原始源代码，因此看不到.cs文件是正常的，完全不影响站点运行。

2. CSS文件缺失的原因及解决办法
   静态资源（如CSS）未被包含到发布包，通常是因为文件的**"复制到输出目录"属性未正确配置**：

   • 右键目标CSS文件 → 打开属性面板
   • 将"复制到输出目录"设置为**"如果较新则复制"或"始终复制"**
   • 重新执行发布操作，CSS文件就会被包含到发布包中

3. 发布与构建的关系
   发布依赖于构建流程：先完成对应配置的构建，再在构建输出的基础上，根据发布配置筛选文件：

   • 保留：编译后的程序集、配置文件、已配置复制属性的静态资源、第三方依赖库等
   • 排除：源文件、编译临时文件、未配置复制属性的本地文件等

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