.NET 8/9 Linux环境下含EXE程序集的NuGet包引用问题咨询

阿华AIGC实验室

2026-4-1

首先给你核心结论：在.NET 8/9下，确实可以创建包含EXE的NuGet包，也能在其他项目中引用它，但你遇到的警告完全是因为.NET Core+和.NET Framework的EXE本质差异，以及默认打包配置的坑导致的，下面一步步拆解原因和解决方案：

为什么会出现这些警告？

你提到NuGet包里同时有MyCompany.MyNugetPackage.exe和MyCompany.MyNugetPackage.dll，这是关键问题所在：

在.NET Framework中，EXE本身就是完整的.NET程序集（包含IL元数据），可以直接被引用；
但在.NET Core/.NET 5+（包括8/9）的Linux环境下，控制台项目生成的EXE是平台特定的本机宿主启动器（ELF格式），它根本不包含.NET元数据——真正的.NET程序集逻辑全在同名的DLL文件里！

这就解释了所有异常：

ILDasm识别不出EXE的元数据：因为它本来就不是.NET程序集；
警告MSB3246：MSBuild尝试读取EXE的元数据但失败了；
警告MSB3243：MSBuild同时看到了exe和dll两个"同名"文件，不知道该选哪个，只能随机选一个。

怎么解决？（从源头修复+临时规避）

方案1：从打包源头解决（推荐）

修改你用来生成NuGet包的控制台项目的.csproj文件，调整打包配置，确保只有真正的.NET程序集（DLL）被当作"可引用的程序集"打包，同时如果需要保留EXE让用户直接运行，把它放到NuGet的tools目录而非lib目录：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <IsPackable>true</IsPackable>
    <!-- 禁止将宿主EXE打包到lib目录（避免被当作程序集引用） -->
    <DisableExeOutputInPackage>true</DisableExeOutputInPackage>
    <PackageOutputPath>bin\NuGet</PackageOutputPath>
  </PropertyGroup>

  <ItemGroup>
    <!-- 手动将EXE添加到tools目录，这样它不会被当作程序集引用，但可以被执行 -->
    <None Include="$(OutputPath)$(AssemblyName).exe" Pack="true" PackagePath="tools" />
  </ItemGroup>
</Project>

这样打包出来的NuGet包，lib目录下只有DLL（会被正确识别为程序集），tools目录下有EXE（可以直接运行），引用项目时就不会有任何警告。

方案2：临时规避（针对已有的问题NuGet包）

如果你不想重新打包，也可以在引用该NuGet包的项目中，强制MSBuild只使用DLL文件：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="MyCompany.MyNugetPackage" Version="2.0.0">
      <!-- 只引用编译时需要的DLL，排除runtime目录下的EXE -->
      <IncludeAssets>compile</IncludeAssets>
      <ExcludeAssets>runtime;contentfiles;build</ExcludeAssets>
    </PackageReference>
  </ItemGroup>
</Project>

或者更直接地，手动指定引用的DLL路径（不过这个方法不够灵活，不推荐长期用）：

<ItemGroup>
  <Reference Include="MyCompany.MyNugetPackage">
    <HintPath>$(UserProfile)\.nuget\packages\mycompany.mynugetpackage\2.0.0\lib\net8.0\MyCompany.MyNugetPackage.dll</HintPath>
  </Reference>
</ItemGroup>