如何让NuGet包以无过滤的默认形式被项目引用？

行为控制因素 #

你的NuGet包包含Analyzer组件是触发该行为的核心原因。NuGet默认将Analyzer这类开发时专用资产视为私有依赖，因此在添加引用时自动生成<PrivateAssets>和<IncludeAssets>节点——目的是确保Analyzer仅在开发阶段生效，不会被传递到下游项目，也不会随最终发布产物打包。即便你没手动设置<DevelopmentDependency>，只要包内包含Analyzer，NuGet就会触发这个默认逻辑。

调整方法 #

如果你确实需要生成无过滤的简洁引用，可以通过以下方式修改类库项目的打包配置：

• 直接调整Analyzer的打包属性：在类库的.csproj文件中，针对Analyzer程序集添加显式配置，取消私有标记：

  <Analyzer Include="你的Analyzer程序集路径">
    <Pack>true</Pack>
    <PrivateAssets>none</PrivateAssets>
    <IncludeAssets>all</IncludeAssets>
  </Analyzer>
  

• 修改引用的Analyzer包属性：如果你的类库是通过引用第三方Analyzer NuGet包集成的，在.csproj中调整该引用的资产规则：

  <PackageReference Include="第三方Analyzer包名" Version="对应版本">
    <PrivateAssets>none</PrivateAssets>
    <IncludeAssets>all</IncludeAssets>
  </PackageReference>
  

• 通过nuspec配置（若使用nuspec打包）：在.nuspec文件的元数据中显式声明非开发依赖，并定义资产规则：

  <metadata>
    <developmentDependency>false</developmentDependency>
  </metadata>
  <files>
    <file src="build/analyzers/**/*" target="build/analyzers" />
  </files>
  

注意：将Analyzer设置为非私有资产后，下游项目引用你的包时也会自动引入该Analyzer，这不符合Analyzer的常规使用场景，请确认你的业务需求是否真的需要这样配置。

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