同一解决方案在不同Windows环境下NuGet包还原差异的问题咨询

平台信息 #

• Windows 10
• Visual Studio 2022
• .NET Core 3.1
• C#

问题描述 #

我有一个包含控制台应用（启动项目）和多个类库项目的小型解决方案。使用Visual Studio构建（msbuild）时，除项目依赖的NuGet包外，还会还原约50个额外的基础架构/SDK/框架类NuGet包（如System、System.Runtime命名空间包）至默认NuGet缓存文件夹。

但在另一Windows环境下使用dotnet build或dotnet publish命令构建该解决方案时，不会还原这些额外NuGet包。

想明确两个问题：

1. 这些额外NuGet包被还原的原因是什么？
2. 如何在第二个环境中创建包含这些NuGet包的相同仓库？

问题解答 #

1. 额外NuGet包被还原的原因

这些基础系统包被还原主要有两个原因：一是Visual Studio内置的msbuild在构建时，默认会兼容.NET Framework相关场景，或是你的项目/某个依赖项的.csproj配置触发了完整框架依赖的还原逻辑；二是Visual Studio为了支持IDE的代码分析、智能提示等功能，会额外拉取这些包，而纯命令行的dotnet build只聚焦于构建运行所需的最小依赖集，不会处理IDE相关的额外依赖。

2. 在第二个环境同步这些NuGet包的方法

• 调整项目配置：在所有项目的.csproj文件中添加<RestoreWithFullFramework>true</RestoreWithFullFramework>配置项，然后运行dotnet restore命令，强制拉取完整的框架相关包。
• 使用Visual Studio Build Tools：在第二个环境安装Visual Studio Build Tools，执行msbuild /t:Restore命令，和Visual Studio内的构建行为保持一致，即可还原那些额外的基础包。
• 导出依赖清单同步：在第一个环境运行dotnet list package --include-transitive > dependencies.txt，导出所有依赖（包括间接的基础包）；在第二个环境里，要么根据清单手动将这些包添加到项目依赖，要么使用nuget restore命令配合这份清单拉取所有包。

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