如何为无互联网的TFS构建服务器正确添加NuGet包？

问题根源 #

你遇到的错误是因为手动复制包文件到本地目录时，没有保留NuGet要求的完整目录结构和必要文件（比如.nuspec），同时构建步骤还在尝试访问外网源，导致超时和包查找失败。

正确添加NuGet包的步骤 #

1. 在联网机器上完整下载包及依赖 #

不要直接复制解压后的文件，用NuGet命令下载完整的包结构：

nuget install <包ID> -Version <版本号> -OutputDirectory <本地临时目录>

示例：

nuget install System.Numerics.Vectors -Version 4.5.0 -OutputDirectory D:\OfflineNuGetPackages

这个命令会自动下载目标包及其所有依赖，并且生成NuGet要求的目录结构（比如System.Numerics.Vectors\4.5.0），包含.nuspec、lib等所有必要文件。

2. 复制完整目录到TFS服务器 #

将联网机器上下载好的整个包目录（比如System.Numerics.Vectors文件夹）复制到TFS服务器的$(NuGetRestorePath)\.nuget\packages\路径下，保持层级结构不变。

3. 确保构建步骤仅使用本地源 #

在TFS构建定义的NuGet Restore步骤中：

• 选择「Feeds to use」为「Feeds in my NuGet.config」，并确保服务器上的NuGet.config只配置了本地源，删除nuget.org的源配置；
• 或者直接在步骤中指定「Package source」为本地源路径，禁用其他外部源，避免构建时尝试访问外网导致超时。

关于.nuspec和包注册的疑问 #

• .nuspec是必须的：NuGet还原时需要读取.nuspec获取包的元数据、依赖关系等信息，缺失会导致无法识别包。但不需要手动生成，用nuget install命令下载的包会自动包含该文件。
• 不需要额外注册包：只要包目录结构正确，且NuGet源指向该目录，就能被自动识别，无需额外注册操作。

额外排查点 #

• 检查服务器上的包目录：确认每个包的版本文件夹下存在.nuspec、lib等文件，结构和联网机器上下载的一致；
• 验证本地源有效性：在TFS服务器上手动运行nuget restore <你的解决方案路径> -Source <本地源路径>，测试是否能成功还原，排除构建步骤的配置问题；
• 确认$(NuGetRestorePath)变量：检查构建定义中的该变量是否指向正确的本地包目录。

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