如何在MSBuild SDK风格C#项目中禁用特定依赖？

我有一个由多个项目（如Projects A、B）组成的应用，每个项目通过<PackageReference Include=...>添加若干直接依赖，这些依赖还包含自动引入的传递依赖（transitive dependencies）。

依赖关系如下：

project A -> library 1
project A -> library 2
project A -> library 3
project B -> library 2
project A -> library 1

library 1 -> Transitive library X
library 3 -> Transitive library Y

我希望在代码库中禁用特定依赖：所有直接使用该依赖的构建都需失败。例如，要阻止Transitive library Y，若有人新增代码直接引用它，构建应失败。请问是否有标准实现方法？还是需要手动分析依赖、自定义MSBuild任务或CI/CD任务？

针对.NET项目的这类需求，有几种标准且成熟的实现方式，无需手动分析依赖：

1. 全局限制直接引用 #

在代码库根目录的Directory.Build.props中添加全局规则，直接禁止项目引用目标包：

<Project>
  <ItemGroup>
    <!-- 若检测到直接引用TransitiveLibraryY，构建直接报错 -->
    <Error Condition="@(PackageReference->AnyHaveMetadataValue('Include', 'TransitiveLibraryY'))" 
           Text="禁止直接引用TransitiveLibraryY，请通过library 3间接使用！" />
  </ItemGroup>
</Project>

任何项目只要直接添加<PackageReference Include="TransitiveLibraryY">，构建时就会触发错误。

2. 用MSBuild包验证功能 #

.NET 6及以上版本内置PackageValidation，可用来管控依赖引用：
在Directory.Build.props或项目文件中配置：

<Project>
  <PropertyGroup>
    <EnablePackageValidation>true</EnablePackageValidation>
  </PropertyGroup>
  <ItemGroup>
    <!-- 禁止直接引用目标包，触发构建错误 -->
    <PackageValidationErrorOnDirectReference Include="TransitiveLibraryY" />
  </ItemGroup>
</Project>

该配置会让直接引用目标包的项目在构建阶段抛出验证错误。

3. NuGet配置层面禁用 #

在NuGet.Config中添加禁止规则，阻止NuGet还原直接引用的目标包：

<configuration>
  <packageSources>
    <!-- 现有包源配置 -->
  </packageSources>
  <disabledPackageSources>
    <add key="TransitiveLibraryY" value="禁止直接引用该包，仅允许间接依赖" />
  </disabledPackageSources>
</configuration>

这种方式会让直接引用目标包的项目在还原阶段失败，进而导致构建终止。

4. CI/CD阶段增强校验 #

如果需要结合代码调用检测（比如不仅禁止引用，还要禁止代码中调用目标库的API），可以在CI/CD流程中加两步：

• 执行dotnet list package --include-transitive导出所有依赖，用脚本筛选出直接引用目标包的项目并报错
• 配合Roslyn分析器，扫描代码中是否存在目标库的命名空间、类型引用，若有则终止构建

前三种属于.NET/NuGet的标准内置方案，无需自定义复杂任务即可满足需求；第四种适合需要更严格管控的场景。

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