为linux-bionic-arm64发布单文件.NET控制台应用报错排查

核心原因 #

PublishSingleFile是.NET的发布阶段特性，并非构建（dotnet build）阶段的配置项。当你在dotnet build命令中结合该参数和特定运行时（linux-bionic-arm64）时，MSBuild会尝试复制仅在发布流程中才会生成的singlefilehost文件，而构建阶段根本不会生成这个文件，因此抛出MSB3030错误。

解决方案 #

1. 使用正确的发布命令 #

将dotnet build替换为dotnet publish——这才是启用Single File特性的正确命令：

dotnet publish "/path/to/MyApp.csproj" --configuration Release --runtime linux-bionic-arm64

该命令会完整执行发布流程，自动生成singlefilehost并打包成单文件可执行程序。

2. 隔离发布配置到特定阶段 #

如果你希望保留dotnet build的正常执行，同时在发布时启用Single File，可以修改.csproj，仅在发布阶段启用该配置：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net7.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <SelfContained>true</SelfContained>
    <RuntimeIdentifiers>linux-x64;linux-bionic-arm64</RuntimeIdentifiers>
    <!-- 仅在发布时启用Single File -->
    <PublishSingleFile Condition="'$(IsPublish)' == 'true'">true</PublishSingleFile>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="MD5" Version="2.0.4" />
    <PackageReference Include="System.CommandLine" Version="2.0.0-beta4.22272.1" />
  </ItemGroup>
</Project>

这样dotnet build会正常执行，而dotnet publish会自动启用单文件打包。

补充说明 #

移除<PublishSingleFile>true</PublishSingleFile>后构建正常，是因为此时构建流程不需要处理单文件打包逻辑，仅生成常规的可执行文件和依赖项，无需寻找singlefilehost文件。

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