如何调试本地私有NuGet仓库中的自有NuGet包？SourceLink支持离线吗？

我来帮你梳理下本地私有NuGet包调试的问题，以及SourceLink的离线支持情况：

一、本地私有NuGet库实现调试的开箱即用方案 #

首先得确保你的本地仓库同时存放了.nupkg和对应的.snupkg符号包——这是实现调试的核心前提。之后在Visual Studio里做这几步配置就能搞定：

• 打开工具 > 选项 > 调试 > 符号，除了默认的Microsoft符号服务器，把你的本地私有NuGet仓库根目录添加到符号源列表中（VS会自动递归查找目录里的.snupkg文件）。
• 关闭调试 > 常规里的仅我的代码选项，这个开关会默认跳过外部库的调试流程。
• 清理旧符号缓存：在符号设置页面点击清除符号缓存，避免之前残留的不匹配pdb干扰新包的调试，之后重启调试即可。

只要你的.snupkg是正确生成的（包含与dll完全匹配的pdb文件），这套配置就是开箱即用的，不需要额外第三方工具。

二、关于之前短暂能调试的原因 #

你提到之前偶尔能调试，确实大概率是因为Visual Studio的符号缓存里还保留着旧版本的pdb文件。当你更新NuGet包但未同步更新对应的.snupkg，或者缓存里的旧pdb与新dll版本不匹配时，就会出现无法调试的情况，清理缓存后重新拉取符号就能验证这一点。

三、SourceLink对离线NuGet存储的支持 #

SourceLink并非只能依赖GitHub、BitBucket这类在线平台，它完全支持离线私有NuGet仓库的场景：

• 你在构建NuGet包时，只需针对本地Git仓库配置SourceLink（比如通过项目文件里的<PublishRepositoryUrl>true</PublishRepositoryUrl>和<EmbedUntrackedSources>true</EmbedUntrackedSources>等属性），生成的.snupkg会包含SourceLink元数据和pdb文件。
• 当你的私有NuGet库是离线存储时，只要.snupkg和.nupkg放在同一仓库目录，且VS符号源配置了该目录，调试器就能从本地.snupkg读取pdb和SourceLink信息，进而找到你本地开发环境中对应版本的源码（前提是你的本地Git仓库保留了对应版本的代码）。

额外小提示 #

• 务必保证.snupkg和.nupkg的版本号、文件名完全对应（比如MyToolkit.2.1.0.nupkg对应MyToolkit.2.1.0.snupkg），否则VS无法关联符号包。
• 如果不想用.snupkg的方式，也可以直接把pdb文件和dll放在.nupkg的lib目录下一起打包，VS引用时会自动加载pdb，不过.snupkg是NuGet官方推荐的符号包规范，更便于管理。

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