如何添加.NET仅编译时依赖 解决ExcludeAssets配置不稳定问题

问题1解答 #

ExcludeAssets="runtime"的设计逻辑本身不会排除构建环节的依赖，该配置的官方语义是仅排除NuGet包中标记为运行时使用的资产，保留编译所需的引用资产。
出现的不稳定表现不属于官方BUG，绝大多数是以下两类原因导致：

• 引用的NuGet包本身不符合资产规范：包作者没有将编译时用的引用程序集单独放到ref目录，而是直接将lib目录下的运行时程序集同时作为编译资产使用，排除runtime资产时会连带把编译资产一起移除
• 本地缓存异常：NuGet资产缓存、VS增量构建缓存冲突，重启VS时缓存被刷新所以问题临时修复

问题2解答 #

以下是不同稳定性等级的实现方案，可根据场景组合使用：

方案1：原生配置（最推荐，对应CopyLocal=false语义） #

直接在PackageReference节点下添加<Private>False</Private>子节点，该配置完全对齐传统非SDK项目的CopyLocal=false逻辑，编译时正常参与构建，不会将程序集复制到输出目录，稳定性远高于仅配置ExcludeAssets：

<PackageReference Include="包名" Version="版本号">
  <Private>False</Private>
</PackageReference>

如果是仅包含常量的纯编译时依赖，可以再加IncludeAssets="compile"进一步限制仅加载编译资产，避免多余资产引入：

<PackageReference Include="常量包名" Version="版本号" IncludeAssets="compile">
  <Private>False</Private>
</PackageReference>

方案2：兜底删除逻辑（适合授权程序集等高风险场景） #

为了完全避免通用授权程序集被误打包的风险，可在项目文件末尾添加构建后删除的目标，做双重校验：

<Target Name="DeleteProhibitedAssemblies" AfterTargets="AfterBuild">
  <!-- 多个需要删除的程序集用分号分隔即可 -->
  <Delete Files="$(OutputPath)授权程序集名称.dll;$(OutputPath)其他不需要的程序集.dll" />
</Target>

该方案会在每次构建完成后强制删除指定文件，无论前面的依赖配置是否生效，都不会出现漏包的情况。

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