如何解决VS Code中C#项目发布时的NETSDK1099错误

项目结构 #

C:\C-SHARP-PROJECTS
|
|--ProjectA
|    |--.vscode
|    |--ProjectA.sln
|    |--Libraries
|    |     |-- ConsoleMsgHelper.cs
|    |     |-- RenamerHelper.cs
|    |     |-- Libraries.csproj
|    |
|    |--ProjectA
|          |--.vscode
|          |-- Program.cs
|          |-- ProjectA.csproj
|
|--Releases
     |--myapp

项目文件内容 #

ProjectA.csproj（可执行项目） #

<Project Sdk="Microsoft.NET.Sdk">

  <ItemGroup>
    <ProjectReference Include="..\Libraries\Libraries.csproj" />
    <Content Update="*-exclude.dll">
      <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
        <ExcludeFromSingleFile>true</ExcludeFromSingleFile>
    </Content>
  </ItemGroup>

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net7.0</TargetFramework>
    <RuntimeIdentifiers>win10-x64</RuntimeIdentifiers>
    <PlatformTarget>x64</PlatformTarget> 
    <PublishSingleFile>true</PublishSingleFile>
    <IncludeAllContentForSelfExtract>True</IncludeAllContentForSelfExtract> 
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

</Project>

Libraries.csproj（类库项目） #

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net7.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>disable</Nullable>
  </PropertyGroup>

</Project>

执行的发布命令 #

• dotnet publish --output "c:/C-SHARP-PROJECTS/Releases/myapp" --runtime win-x64 --configuration Release -p:PublishSingleFile=true -p:PublishTrimmed=true --self-contained true
• dotnet publish --output "c:/C-SHARP-PROJECTS/Releases/myapp" --runtime win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeAllContentForSelfExtract=true
• dotnet publish --property:PublishDir="c:/C-SHARP-PROJECTS/Releases/myapp" --configuration Release --runtime win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeAllContentForSelfExtract=true

错误信息 #

C:\Program Files\dotnet\sdk\7.0.100\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Publish.targets(94,5): error NETSDK1099: 发布为单文件仅支持可执行应用程序。 [C:\C-SHARP-PROJECTS\ProjectA\Libraries\Libraries.csproj]

解决方法 #

方法1：指定发布可执行项目文件 #

问题根源是发布命令默认针对整个解决方案或类库项目执行，而单文件发布仅支持可执行项目。修改命令，明确指定要发布的可执行项目路径：

dotnet publish "C:\C-SHARP-PROJECTS\ProjectA\ProjectA\ProjectA.csproj" --output "c:/C-SHARP-PROJECTS/Releases/myapp" --runtime win-x64 --configuration Release -p:PublishSingleFile=true -p:PublishTrimmed=true --self-contained true

或者先进入可执行项目目录再执行命令：

cd C:\C-SHARP-PROJECTS\ProjectA\ProjectA
dotnet publish --output "../../Releases/myapp" --runtime win-x64 --configuration Release -p:PublishSingleFile=true -p:PublishTrimmed=true --self-contained true

方法2：在类库项目中添加条件配置 #

如果需要保留针对解决方案的发布命令，可在Libraries.csproj的<PropertyGroup>中添加条件，禁止类库应用单文件发布设置：

<PropertyGroup>
  <TargetFramework>net7.0</TargetFramework>
  <ImplicitUsings>enable</ImplicitUsings>
  <Nullable>disable</Nullable>
  <!-- 仅当项目为可执行类型时才启用单文件发布 -->
  <PublishSingleFile Condition="'$(OutputType)' != 'Exe'">false</PublishSingleFile>
</PropertyGroup>

这样即使发布整个解决方案，类库项目也会自动跳过单文件发布配置，避免触发错误。

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