MSBuild发布Blazor Web App与Visual Studio输出差异问题排查

我正在为基于Blazor的Web应用制作安装程序，写了一个多目标的setup.build文件，目前聚焦于Web应用的发布目标。发现通过Visual Studio发布和MSBuild脚本发布的输出有差异：

• 脚本发布时，DLL文件被复制到bin目录，Visual Studio发布没有这个目录
• 脚本发布没有生成执行文件，VS发布则有

执行该目标前已经重建了整个解决方案，当前的发布目标代码片段如下：

<Target Name="PublishWebsite">
  <!-- Remove complete publish folder in order to 
           be sure that everything will be newly compiled -->
  <Message Text="Removing publish directory: $(SetupF)"/>
  <RemoveDir Directories="$(SetupF)" ContinueOnError="false" />
  <Message Text="Start to publish website" Importance="high" />
  <MSBuild
      Projects="..\MyWebApp.csproj"
      Targets="ResolveReferences;_CopyWebApplication"
      Properties="OutDir=$(Publish)bin\;WebProjectOutputDir=
                      $(Publish);Configuration=Release" />
</Target>

请问是构建脚本的目标或属性配置错误，还是其他原因？

解决方案 #

你的问题完全是目标选择和属性配置错误导致的，具体问题和修正方法如下：

1. 错误根源 #

你当前使用的ResolveReferences;_CopyWebApplication是旧版ASP.NET Web Forms/MVC的构建目标，并非Blazor项目专用的发布目标。这两个目标只会完成基础的引用解析和文件复制，不会处理Blazor发布所需的特殊逻辑（比如可执行文件生成、正确的文件结构整理）。同时，OutDir和WebProjectOutputDir的手动配置打乱了发布目录的结构，导致DLL被错误放到bin目录。

2. 修正后的脚本 #

替换成官方推荐的Publish目标，这也是Visual Studio发布时实际调用的目标：

<Target Name="PublishWebsite">
  <!-- 清理发布目录 -->
  <Message Text="Removing publish directory: $(SetupF)" />
  <RemoveDir Directories="$(SetupF)" ContinueOnError="false" />
  <Message Text="Start to publish website" Importance="high" />
  <!-- 使用官方Publish目标，指定发布目录和配置 -->
  <MSBuild
      Projects="..\MyWebApp.csproj"
      Targets="Publish"
      Properties="PublishDir=$(Publish);Configuration=Release" />
</Target>

3. 关键配置说明 #

• 改用Publish目标：该目标会自动处理所有Blazor发布逻辑，包括正确的文件结构（不会生成多余的bin目录）、可执行文件生成（针对Blazor Server或独立部署的WASM项目）、依赖项整理等。
• 使用PublishDir属性：这是发布目标的标准属性，用来指定最终输出目录，不需要手动设置OutDir和WebProjectOutputDir。
• 可选：独立部署配置：如果需要生成包含.NET运行时的独立可执行文件，在Properties中添加SelfContained=true；如果是框架依赖部署，可省略或设为false。

4. 额外提示 #

执行前的重建步骤可以保留，但Publish目标本身会自动处理必要的编译和清理，确保输出是最新的，无需额外手动操作。

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