如何为VS2022编译的C++库创建含Lib、PDB及源码的可调试NuGet包？

完全可以实现你的需求——不需要依赖SourceLink或额外服务，直接把PDB文件和源码打包进NuGet包，再通过.targets文件配置调试路径，就能让无源码仓库权限的机器正常调试。

1. 修改.nuspec文件，添加PDB与源码 #

在现有<files>节点中，新增PDB文件和源码文件的打包规则：

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
  <metadata>
    <!-- 保留原元数据不变 -->
    <id>Corp.MyLib.Cpp</id>
    <version>0.1.0.0</version>
    <description>My library</description>
    <authors>Me</authors>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <tags>native, nativepackage, mylib, C++, Corp</tags>
    <dependencies>
      <group targetFramework="native0.0" />
    </dependencies>
  </metadata>
  
  <files>
    <!-- 保留原有文件条目 -->
    <file src=".\Corp.MyLib.Cpp.targets" target="build\native\Corp.MyLib.Cpp.targets" />
    <file src="..\Build\**\*.h" target="lib\native\include" />
    <file src="..\Build\Lib\**" target="build\native\lib\" />
    
    <!-- 新增：打包PDB文件（与库文件同目录） -->
    <file src="..\Build\Lib\**\*.pdb" target="build\native\lib\" />
    
    <!-- 新增：打包所有源码文件（根据实际源码目录调整src路径） -->
    <file src="..\Src\**\*.cpp" target="build\native\src\" />
    <file src="..\Src\**\*.h" target="build\native\src\" />
  </files>
</package>

注意：如果你的源码目录不是..\Src，请替换为实际路径；确保PDB文件和对应的库文件（.lib/.dll）在包内处于同层级目录，这样Visual Studio加载库时会优先匹配同目录的PDB。

2. 配置.targets文件，指定调试路径 #

打开Corp.MyLib.Cpp.targets，添加以下属性配置，告知Visual Studio符号与源码的搜索路径：

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <!-- 保留原有targets配置 -->
  
  <PropertyGroup>
    <!-- 添加符号搜索路径：递归查找包内lib目录下的PDB -->
    <NativeDebuggerSymbolSearchPath>$(MSBuildThisFileDirectory)lib\**;$(NativeDebuggerSymbolSearchPath)</NativeDebuggerSymbolSearchPath>
    
    <!-- 添加源码搜索路径：递归查找包内src目录下的源码文件 -->
    <SourcePath>$(MSBuildThisFileDirectory)src\**;$(SourcePath)</SourcePath>
  </PropertyGroup>
</Project>

3. 构建并测试NuGet包 #

• 重新生成NuGet包：执行命令 nuget pack Corp.MyLib.Cpp.nuspec
• 将生成的.nupkg文件上传到内部网络共享的NuGet源
• 在目标机器上安装包并创建测试项目引用该库
• 启动调试：断点命中库代码时，Visual Studio会自动加载包内的PDB和源码，无需额外配置

关键提示 #

• PDB必须与库文件为同一次编译产物，否则会出现符号不匹配无法调试的问题
• 无需SourceLink：直接打包源码到包内，VS通过本地路径即可获取源码，无需依赖远程仓库
• 包体积：该方案会增大包体积，但完全适配你的内部小型团队场景

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