VS17调试自定义C++ NuGet包无法单步进入问题求助

我正尝试将一个C++ NuGet包发布到公司内部NuGet源，但调试时无法通过F11单步进入包内函数。已完成以下操作但问题仍未解决：

• 在VS17中启用“调试非仅我的代码”选项
• 将编译生成的vc110.pdb文件包含进NuGet包
• 在.nuspec文件中添加<repository type="git" url="http://xxxx" />标签

关键限制条件 #

• 未使用NuGet打包的-Symbols选项：该选项会生成两个包，第二个包推送到源时提示重复
• /SourceLink不适用：仅支持C#，无法用于C++场景
• 只能使用自定义.nuspec：通过.vcxproj打包时NuGet提示未提供输入文件
• Git仓库托管在Azure DevOps TFS服务器
• 使用VS17，但编译工具链为vc110（VS2012）

当前.nuspec内容 #

<package >
  <metadata>
    <id>x</id>
    <version>1.0.2</version>
    <title>$title$</title>
    <authors>x</authors>
    <projectUrl>yyy</projectUrl>
    <description>static .lib</description>
    <tags>native</tags>
    <repository type="git" url="yyy" />
  </metadata>
  <files>
    <file src="include\**\*.*" target="include" /> 
    <file src="x64\**\*.lib" target="lib\x64" /> 
    <file src="x64\**\*.pdb" target="lib\x64" /> 
    <file src="build\**\*.*" target="build" /> 
  </files>
</package>

C++专属解决方案 #

1. 确保PDB与Lib严格匹配 #

PDB必须是和当前Lib同一编译批次生成的，不能混用不同版本或配置的文件。重新编译包时，确保修改代码后同时生成新的Lib和PDB，避免单独替换其中一个文件。

2. 调整NuGet包内PDB的存放路径 #

VS调试器对原生C++包的符号路径识别有特定要求，尝试将PDB移至symbols目录，修改.nuspec的files节点：

<file src="x64\**\*.pdb" target="symbols\x64" /> 

同时补充repository的commit信息（如果可获取），帮助VS关联源代码：

<repository type="git" url="yyy" commit="你的Git提交哈希值" />

3. 配置VS17的符号加载规则 #

• 打开调试 -> 选项 -> 符号：
  • 勾选“Microsoft符号服务器”（避免系统符号缺失干扰调试）
  • 添加公司NuGet源地址到符号搜索路径
  • 取消勾选“仅指定模块加载符号”，或手动将你的包Lib添加到允许列表
• 调试时打开模块窗口（调试 -> Windows -> 模块）：
  • 找到你的包对应的Lib模块，查看符号状态
  • 若显示“未加载符号”，右键选择“加载符号”，手动指向NuGet包解压后的PDB路径
  • 若提示PDB不匹配，重新编译生成匹配的Lib和PDB

4. 确保VS17兼容vc110工具集 #

• 通过VS安装器安装“Visual C++ 2012 工具集”组件，确保VS17能正确识别vc110格式的PDB
• 编译C++包时，调试信息格式选择程序数据库(/Zi)，避免使用“编辑并继续”的/ZI格式（后者生成的PDB兼容性差）

5. 手动关联源代码路径 #

若VS无法自动找到包的源代码：

• 调试时跳转到反汇编页面后，右键选择“源文件设置”
• 添加你的C++包源代码所在的本地Git仓库路径，或直接指向NuGet包中打包的源文件（可在.nuspec中添加源文件到src目录）

6. 清理NuGet缓存 #

删除本地NuGet缓存目录%userprofile%\.nuget\packages\x（x为你的包ID），重新拉取包，确保使用的是包含正确PDB的最新版本

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