Visual Studio安装NuGet包提示需源映射，全项目均遇此问题求解决

安全阿岳

2026-7-6

解决NuGet安装提示“Requires a package source mapping”问题

检查并配置包源映射
打开Visual Studio的工具 → 选项 → NuGet包管理器 → 包源，点击右上角的包源映射按钮，在弹出窗口里点击添加包源映射，选择常用的包源（比如nuget.org），在包ID前缀输入*（匹配所有包），保存后重启Visual Studio。
手动修改NuGet全局配置文件
找到对应系统的配置文件路径：
- Windows：%appdata%\NuGet\NuGet.Config
- macOS/Linux：~/.nuget/NuGet/NuGet.Config
  打开文件，在<configuration>节点内添加以下配置：
```
<packageSourceMapping>
  <packageSource key="nuget.org">
    <package pattern="*" />
  </packageSource>
</packageSourceMapping>
```
保存文件后重启Visual Studio。
重置包源后重新配置
回到包源设置页面，点击重置所有包源恢复默认配置，再重复第一步的包源映射配置操作。
临时禁用强制检查（不推荐长期使用）
如果以上方法都没效果，可以在NuGet.Config文件的<configuration>节点内添加：
```
<config>
  <add key="RequirePackageSourceMapping" value="false" />
</config>
```
保存后重启Visual Studio即可临时绕过检查，但建议后续还是配置好包源映射以遵循安全规范。