同版本MSBuild本地可还原NuGet包，构建服务器无法还原问题求助

关于nuget restore仅处理packages.config的疑问 #

这是符合旧版NuGet CLI行为的：早期版本的NuGet CLI（v4.x及更早）默认仅识别基于packages.config的包引用，不会自动处理.csproj中的PackageReference。要让NuGet CLI处理PackageReference，需要升级到较新版本的NuGet CLI，或者配合MSBuild的还原命令使用。

核心原因：构建服务器缺少NuGet与MSBuild的集成组件 #

本地安装的完整Visual Studio会自动安装NuGet与MSBuild的集成组件（包含处理PackageReference所需的MSBuild目标文件），而单独安装的MSBuild默认不包含这些组件，导致无法识别并还原.csproj中的包引用。

具体解决方案 #

1. 使用.NET SDK自带的还原命令 #

如果项目兼容.NET Core/.NET 5+，直接在构建服务器上安装对应版本的.NET SDK，然后执行：

dotnet restore YourSolution.sln

.NET SDK自带了MSBuild和完整的NuGet集成，能自动处理PackageReference，无需依赖Visual Studio。

2. 升级NuGet CLI并指定正确参数 #

下载并安装最新版的NuGet CLI到构建服务器，然后执行还原命令时指定解决方案文件：

nuget restore YourSolution.sln

新版NuGet CLI会自动识别.csproj中的PackageReference并处理。

3. 为MSBuild安装NuGet集成组件 #

如果必须使用单独的MSBuild（而非.NET SDK附带的），可以通过以下方式添加NuGet集成：

• 安装NuGet.Build.Tasks.Pack包到MSBuild的扩展目录：

  nuget install NuGet.Build.Tasks.Pack -OutputDirectory "C:\Program Files\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\Sdk"
  

  （路径根据构建服务器上的MSBuild安装位置调整）
• 或者直接从NuGet官方渠道下载NuGet的MSBuild目标文件，放到MSBuild的Sdk\NuGet目录下。

4. 确保MSBuild还原命令的正确性 #

执行msbuild -t:restore时，必须指定目标解决方案或项目文件，否则可能无法正确遍历所有项目：

msbuild YourSolution.sln -t:restore -p:Configuration=Debug

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