如何在NuGet.Config中按包ID与版本配置PackageSourceMapping

正确的NuGet.config配置方案 #

要实现需求中的包源映射并消除NU1507警告，需在NuGet.config中完成包源定义和包源映射规则的完整配置，具体代码如下：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <!-- 定义生产包源（nuget.org） -->
    <add key="nuget-org" value="https://api.nuget.org/v3/index.json" />
    <!-- 定义预览包源（cloudsmith），替换为你的实际仓库地址 -->
    <add key="cloudsmith-preview" value="https://nuget.cloudsmith.io/[你的仓库标识]/v3/index.json" />
  </packageSources>

  <packageSourceMapping>
    <!-- 规则1：ID以PackagePrefix.开头 + 版本含-preview-的包，从cloudsmith拉取 -->
    <packageSource key="cloudsmith-preview">
      <package pattern="PackagePrefix.*" version="*-preview-*" />
    </packageSource>

    <!-- 规则2：所有其他包，从nuget.org拉取（必须配置，否则触发NU1507警告） -->
    <packageSource key="nuget-org">
      <package pattern="*" />
    </packageSource>
  </packageSourceMapping>
</configuration>

关键注意事项 #

• NuGet版本要求：必须使用NuGet 6.0或更高版本，因为package元素的version通配符匹配是6.0版本新增的特性，旧版本不支持该语法。
• 包源Key匹配：packageSource的key必须和packageSources中定义的源key完全一致，否则映射规则不生效。
• 全局通配符映射：最后的<package pattern="*" />是解决NU1507警告的核心——中央包管理要求所有包都必须有明确的源映射，这条规则会兜底处理所有未匹配到cloudsmith规则的包。

规则验证 #

• 对于PackagePrefix.SomeProject（版本2.5.0）：不满足*-preview-*版本规则，会匹配nuget-org的全局通配符，从nuget.org拉取。
• 对于PackagePrefix.SomeOtherProject（版本2.6.0-preview-5）：同时满足PackagePrefix.*的ID规则和*-preview-*的版本规则，会从cloudsmith-preview源拉取。

旧配置失效的可能原因 #

1. NuGet版本低于6.0，无法识别version属性的通配符匹配。
2. 未配置全局通配符映射，导致NuGet无法确定所有包的源，触发NU1507警告同时影响规则生效。
3. 包源的key与映射规则中的key不匹配，导致规则绑定到错误的源。

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