无法修改依赖包B时，如何隐藏NuGet传递依赖的Json.NET类型

问题背景 #

我开发了一个.NET 8 NuGet包“A”，依赖第三方NuGet包“B”，“B”又依赖Json.Net（Newtonsoft.Json），依赖链如下：

"A" -> "B" -> "JSON.NET"

由于NuGet的传递性，使用“A”的消费者会自动获得Json.Net的访问权限，但这些消费者实际使用System.Text.Json作为JSON库，造成了依赖污染：

"Consumer" -> "A" -> "B" -> "JSON.NET"
    └────────────────────────────┘

需求是隐藏包“B”暴露的Json.NET类型，且无法修改包“B”的源代码，因此无法为其设置PrivateAssets="all"。

可行解决方案 #

1. 在包“A”中配置<PackageReference>控制B的依赖可见性 #

虽然无法修改B的源代码，但可以在A的项目文件（.csproj）中对B的引用设置PrivateAssets，限制其依赖的传递性：

<PackageReference Include="B" Version="x.x.x">
  <!-- 阻止编译时资产暴露给消费者，仅保留运行时所需 -->
  <PrivateAssets>compile,contentFiles,build</PrivateAssets>
  <!-- 确保运行时依赖正常传递，保证A功能可用 -->
  <IncludeAssets>runtime, build, native, contentfiles, analyzers, buildtransitive</IncludeAssets>
</PackageReference>

• PrivateAssets="compile"：让B的编译时资产（如程序集、类型定义）无法被消费者项目引用，消费者无法直接访问B或其依赖的Json.NET类型。
• 必须保留IncludeAssets中的runtime，确保A运行时能正常加载B及其依赖。

2. 封装公共API隔离依赖类型 #

如果B的类型已经出现在A的公共API中（比如A的方法返回B定义的类型，且该类型包含Json.NET相关成员），需要对这些类型进行封装：

• 定义A专属的公共DTO或接口，将B返回的类型转换为A内部的类型，对外仅暴露A的类型。
• 示例：若B有BResult类型包含Json.NET的JObject属性，在A中创建AResult类型，将JObject转换为System.Text.Json.JsonElement或自定义模型后再对外提供。

3. 使用ExcludeAssets精准排除特定依赖 #

如果仅需隐藏Json.NET而保留B的其他依赖，可以在A的项目文件中对B的引用添加ExcludeAssets：

<PackageReference Include="B" Version="x.x.x">
  <!-- 排除编译时的Json.NET资产 -->
  <ExcludeAssets>compile</ExcludeAssets>
</PackageReference>

注意：这种方式要求A的代码中没有直接引用Json.NET的类型，仅通过B间接使用，否则会导致A编译报错。

4. 用内部类库做隔离层 #

创建一个内部类库项目（如“A.Internal”），专门负责引用B和Json.NET，A的主项目仅引用这个内部类库，并设置其PrivateAssets="all"：

<!-- A的.csproj中引用内部类库 -->
<ProjectReference Include="..\A.Internal\A.Internal.csproj">
  <PrivateAssets>all</PrivateAssets>
</ProjectReference>

内部类库封装所有与B的交互逻辑，对外暴露的API不包含任何B或Json.NET的类型，主项目A仅提供干净的公共API。

总结 #

优先通过<PackageReference>的PrivateAssets配置控制依赖可见性；若B的类型已出现在A的公共API中，必须通过类型封装或内部类库的方式彻底隔离依赖，切断消费者与Json.NET的编译时关联。

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