TFS 2018私有NuGet源误报内部包缺失问题求助

遇到这种VS能看到包列表但安装时报找不到的情况，大概率是权限、缓存或者源配置的细节问题，咱们一步步来排查：

1. 先确认包在TFS源里真的能被访问 #

先登录TFS的Web管理界面，进入你的Packages包源对应的Web页面，直接搜索<PackageName>：

• 看看包是不是真的存在，有没有被误删除；
• 检查包的权限设置：进入包的详情页，查看权限，确认当前登录VS的用户拥有读取和下载权限——有时候权限只开了浏览，没开下载就会出现能看不能装的情况。

2. 清理NuGet本地缓存 #

本地缓存损坏是常见的坑，VS读取的是源的列表，但安装时可能调用了本地缓存的错误数据：

• 方法一：用NuGet CLI清理：打开命令提示符，运行 nuget locals all -clear；
• 方法二：在VS里操作：点击「工具」→「选项」→「NuGet包管理器」→「常规」，点击「清除所有NuGet缓存」按钮，然后重启VS再试。

3. 用NuGet CLI测试源的可用性 #

跳过VS的干扰，直接用NuGet命令行工具验证源是否能正常下载包：

1. 先搜索包：nuget list <PackageName> -Source http://server3:8080/tfs/InteXX/_packaging/Packages/nuget/v3/index.json
   • 如果能搜到，说明源本身没问题，问题出在VS端；
   • 如果搜不到，那就是TFS源的配置或者权限有问题，回到第一步重新检查。
2. 尝试直接安装：nuget install <PackageName> -Source http://server3:8080/tfs/InteXX/_packaging/Packages/nuget/v3/index.json
   • 如果CLI能安装成功，那就是VS的NuGet扩展或者配置有问题，继续下一步。

4. 更新VS 2017的NuGet包管理器 #

VS2017自带的NuGet版本可能比较旧，对TFS 2018的v3源兼容性不够：

• 打开VS，点击「工具」→「扩展和更新」→「联机」，搜索「NuGet Package Manager for Visual Studio 2017」，安装最新的兼容版本，然后重启VS。

5. 切换到TFS NuGet v2源试试 #

有时候v3源的配置在TFS 2018里会有小问题，换成v2版本的源URL试试：

• 在VS的「工具」→「选项」→「NuGet包管理器」→「包源」里，添加一个新源，URL填 http://server3:8080/tfs/InteXX/_packaging/Packages/nuget/v2/；
• 禁用原来的v3源，用这个新的v2源尝试安装包。

6. 检查代理和网络设置 #

如果你的环境需要代理访问内部服务，可能VS的代理配置有问题：

• 点击「工具」→「选项」→「NuGet包管理器」→「包源」→点击右上角的「设置」按钮，检查代理是否正确配置；
• 或者暂时关闭代理（如果允许的话），再尝试安装，排除代理拦截的问题。

7. 确认包版本的正确性 #

有时候是选了不存在的版本导致报错：

• 在TFS的包详情页里，确认包的所有可用版本号；
• 在VS的NuGet包管理器里，手动指定正确的版本号进行安装，避免选到已被删除的版本。

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