如何在.NET Core解决方案中制作统一NuGet包以规避二进制版本冲突

嘿，这个需求我之前在团队里刚好落地过，太懂你不想因为分散的NuGet包版本不一致搞出各种奇怪问题的痛点了！下面给你分享几个经过实操验证的思路：

本质就是做一个“空壳”类库，把你解决方案里所有需要对外发布的项目都聚合进去，最终只输出一个统一的NuGet包。

• 第一步：创建空的聚合类库项目
  不用写任何业务代码，它就是个“容器”。右键你的解决方案→添加→新建项目，选「类库（.NET Core）」就行，名字可以起得直白点，比如YourSolution.UnifiedPackages，方便后续识别。

• 第二步：引用所有目标子项目
  在这个聚合类库上右键→添加→项目引用，把你要打包的所有项目都勾选上。一定要选「项目引用」而不是直接引用DLL，这样后续子项目更新时，聚合包能自动同步依赖，避免手动复制DLL的麻烦。

• 第三步：配置NuGet包元数据
  编辑聚合类库的.csproj文件，添加必要的NuGet配置，示例如下：

  <PropertyGroup>
    <PackageId>YourCompany.YourSolution.UnifiedPackage</PackageId>
    <Version>1.0.0</Version>
    <Authors>Your Team Name</Authors>
    <Description>统一包含解决方案内所有业务类库的NuGet包，彻底避免版本不一致问题</Description>
    <GeneratePackageOnBuild>true</GeneratePackageOnBuild> <!-- 编译时自动生成NuGet包 -->
  </PropertyGroup>
  

  其中GeneratePackageOnBuild是个实用配置，每次编译项目都会自动在输出目录生成.nupkg文件，不用手动执行打包命令。

• 第四步：处理依赖与冗余

  • 子项目的外部NuGet依赖会自动被聚合包继承，其他项目安装这个统一包时，会自动获取所有必要的依赖，不用额外配置。
  • 如果有些子项目不需要包含进统一包（比如内部测试工具类库），直接在项目引用里取消勾选即可；或者在.csproj里给对应引用加上<PrivateAssets>all</PrivateAssets>标记，避免把它打包进去。

• 第五步：打包与测试

  • 直接编译聚合类库，就能在bin/Debug或bin/Release目录下拿到生成的.nupkg文件。
  • 也可以用命令行打包：打开终端到聚合类库目录，运行dotnet pack --configuration Release，生成的包会在bin/Release文件夹里。
  • 测试时新建一个空白项目，安装这个统一包，检查是否能正常引用所有子项目的类，并且依赖版本完全一致。

如果想让所有子项目和聚合包共用同一个版本号，彻底杜绝版本差异，可以在解决方案根目录创建一个Directory.Build.props文件，内容如下：

<Project>
  <PropertyGroup>
    <Version>1.0.0</Version>
    <PackageVersion>$(Version)</PackageVersion>
  </PropertyGroup>
</Project>

这样所有项目都会自动继承这个版本号，后续更新版本只需要修改这一个文件就行，非常省心。

• 确保所有子项目的目标框架和聚合类库一致（比如都是.NET 6.0），避免打包时出现兼容性问题。
• 控制台、Web项目这类不需要被其他项目引用的项目，建议不要包含进统一包，只打包类库类型的项目即可。

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