C#多项目解决方案如何实现类似SBT的集中式依赖管理

和SBT独立文件管理依赖的逻辑完全对齐的原生方案是使用MSBuild内置的集中包版本管理机制，不需要创建任何仅用于依赖管理的空项目，VS Code + OmniSharp + dotnet CLI全链路原生支持，不需要依赖Visual Studio的GUI工具。

核心配置：全局统一版本管控 #

步骤1：创建独立的版本定义文件 #

在解决方案根目录（所有项目csproj所在的最上层公共父目录）新建名为Directory.Packages.props的文件，全解决方案所有NuGet包的版本号都在这个文件里统一定义，示例配置：

<Project>
  <PropertyGroup>
    <!-- 开启全局集中包版本管理能力 -->
    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
    <!-- 可选：强制统一传递依赖版本，避免不同子项目拉取到不同版本的底层传递包 -->
    <CentralPackageTransitivePinningEnabled>true</CentralPackageTransitivePinningEnabled>
  </PropertyGroup>
  <ItemGroup>
    <!-- 在这里声明所有用到的包和对应版本，是全仓唯一的版本规则源 -->
    <PackageVersion Include="Newtonsoft.Json" Version="13.0.3" />
    <PackageVersion Include="Microsoft.Extensions.Logging" Version="8.0.0" />
    <PackageVersion Include="xunit" Version="2.6.6" />
    <PackageVersion Include="Moq" Version="4.20.70" />
  </ItemGroup>
</Project>

步骤2：子项目简化包引用 #

所有子项目的csproj文件中引用包时，不需要再填写Version属性，版本号会自动从根目录的props文件读取，示例：

<ItemGroup>
  <PackageReference Include="Newtonsoft.Json" />
  <PackageReference Include="Microsoft.Extensions.Logging" />
</ItemGroup>

这种写法直接解决两个核心痛点：

• 升级依赖版本只需要修改Directory.Packages.props里对应条目的Version值，所有引用该包的项目会自动生效，不需要逐个翻找修改分散在各个csproj里的配置
• 每个csproj里只保留当前项目实际引用的包列表，打开文件就能直接看清该项目的直接依赖，不会被中间层干扰依赖关系判断

进阶：按目录批量注入公共依赖 #

如果某一类项目（比如所有测试项目、所有业务服务项目）公用一组固定依赖，不需要每个项目重复写引用声明，也不需要建空项目传递依赖，直接在对应分类的目录下创建Directory.Build.props文件即可，该目录下的所有子项目会自动继承文件里的配置。
举个例子，所有测试项目都统一放在tests/目录下，只要在tests/目录新建Directory.Build.props：

<Project>
  <ItemGroup>
    <!-- 该目录下所有测试项目会自动引用以下包，不需要在每个测试项目的csproj里重复写引用 -->
    <PackageReference Include="xunit" />
    <PackageReference Include="xunit.runner.visualstudio" />
    <PackageReference Include="Moq" />
  </ItemGroup>
</Project>

VS Code 工作流常用操作命令 #

整套方案完全不需要依赖Visual Studio的NuGet图形管理器，所有操作都可以通过dotnet CLI完成，OmniSharp会自动识别上述props文件的配置，不需要额外安装插件：

• 梳理全量依赖关系：在解决方案根目录执行 dotnet list package --include-transitive，会按项目维度列出所有直接依赖、传递依赖和对应版本，比手动翻文件效率高很多
• 检查可升级的依赖：执行 dotnet list package --outdated，会自动列出所有存在新版本的包，标注当前使用版本和最新稳定版，直接去Directory.Packages.props修改对应版本号后执行dotnet restore即可完成升级
• 为指定项目添加新包：进入对应项目目录执行 dotnet add package <包名>，开启集中版本管理后，CLI会自动从根目录的props文件匹配版本；如果props里没有对应包的版本定义，CLI会提示选择版本并自动写入props文件，不需要手动编辑XML

不建议采用创建空项目传递依赖的方案：这种方式会引入不必要的项目引用，传递依赖的边界会变得模糊，后续如果空项目新增了无关依赖，所有引用它的项目都会被动引入无关包，还会拖慢整体构建速度，属于绕弯路实现原生已经支持的能力。

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