NuGet还原时尝试下载非项目依赖包Microsoft.Net.Sdk.Compilers.Toolset

可能的触发原因 #

1. 旧SDK/编译器属性触发隐式依赖：如果你的项目基于.NET Framework或早期.NET Core SDK（比如你本地安装的2.1、5.0版本），或者项目里设置了LangVersion、UseRoslynCompiler这类编译器相关属性，MSBuild会自动尝试拉取Microsoft.Net.Sdk.Compilers.Toolset包，哪怕没写显式依赖。
2. 全局/解决方案级配置注入：解决方案根目录的Directory.Build.props、Directory.Build.targets，或者项目里的隐藏配置文件，可能偷偷加了对这个工具包的引用。
3. 缓存残留干扰：NuGet本地缓存、项目obj目录里的旧配置文件，可能让还原逻辑误判需要这个包。
4. MSBuild版本不匹配：你用-MSBuildVersion latest指定最新版MSBuild，但项目实际依赖的是旧SDK，版本不兼容导致触发额外的工具包下载逻辑。

解决办法 #

1. 排查配置文件里的隐式引用 #

去翻解决方案和项目目录下的Directory.Build.props、Directory.Build.targets，还有.csproj文件：

• 查看有没有<Import>标签引入和Microsoft.Net.Sdk.Compilers.Toolset相关的Targets；
• 检查有没有设置UseRoslynCompiler=true、特定LangVersion这类属性；
• 确认项目的<Project Sdk="Microsoft.NET.Sdk">是不是正确的，别用过时的SDK。

2. 直接禁用隐式编译器包引用 #

在项目文件或者根目录的Directory.Build.props里加这段配置，强制阻止MSBuild自动拉取这个包：

<PropertyGroup>
  <DisableImplicitCompilerPackageReferences>true</DisableImplicitCompilerPackageReferences>
</PropertyGroup>

3. 清理缓存与临时文件 #

先把NuGet缓存和项目构建残留清干净：

# 清空所有NuGet本地缓存
nuget locals all -clear

# 彻底清理项目的构建输出和临时文件
dotnet clean -all

4. 匹配MSBuild和项目SDK版本 #

别再用-MSBuildVersion latest，换成和项目SDK对应的MSBuild版本。比如项目用.NET 5.0，就用16.x系列的MSBuild：

nuget restore -NoHttpCache -DirectDownload -MSBuildVersion 16.11.0

5. 检查NuGet源（可选） #

如果确实需要这个包（只是当前找不到），确认你的NuGet源里包含nuget.org：

# 查看当前源列表
nuget sources list

# 添加nuget.org源（如果缺失）
nuget sources add -name nuget.org -source https://api.nuget.org/v3/index.json

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