Visual Studio 2019 NuGet包管理器无法读取网络共享源子文件夹内的包

核心原因 #

• Visual Studio 2019 内置的 NuGet 包管理器版本对UNC网络共享路径的层级式源扫描逻辑存在兼容性差异：本地NTFS路径下会默认递归扫描子目录读取包元数据，而UNC路径下默认仅扫描根目录下的nupkg文件，不会深入二级及以上子目录识别包，这是该版本NuGet客户端的已知行为。
• 低版本SMB共享协议的限制：如果网络共享使用SMB 2.0及以下版本提供服务，NuGet客户端在枚举子目录的文件元数据时会出现请求延迟或校验失败，直接终止子目录扫描流程，即便账号有正常访问权限也无法识别嵌套的包。
• 手动上传的目录结构缺少NuGet官方索引标识：你手动上传的层级结构仅在本地NTFS环境下可被识别，UNC路径下需要NuGet官方命令生成的结构才会触发客户端的递归扫描逻辑。

修复方案 #

• 调整NuGet配置并使用官方命令初始化共享源：
  1. 首先删除共享目录内已上传的testlib等手动创建的目录
  2. 在本地命令行执行命令，将本地的包批量导入共享源生成规范层级结构：nuget init 本地存储所有nupkg的目录路径 \\networkfolder\nugetfeed\
  3. 打开%AppData%\NuGet\NuGet.config文件，确认你的私有源配置已正确关联该UNC路径，重启Visual Studio即可。
• 升级共享服务的SMB协议版本至3.0及以上，同时在Windows凭据管理器中提前保存该共享文件夹的访问账号密码，避免运行时权限校验超时导致扫描中断。
• 临时规避方案：直接采用平面布局，将所有nupkg文件统一放在共享源根目录下，该布局对UNC路径的兼容性最佳，无需额外调整配置即可被正常识别。

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