Visual Studio中NuGet包内资源字典Go to definition失效问题

问题描述 #

我有一个名为Components的项目，内含TestResourceDictionary.xaml资源字典。直接引用该项目时，根启动项目能正常访问其中的SolidColor画刷、字体文件等静态资源，且Go to definition功能正常。但将Components打包为包含.pdb文件的NuGet包后，引用该包并移除原项目，对资源字典项使用Go to definition时，Visual Studio会提示“Resource definition not available”错误。

功能可用/失效场景 #

可用场景 #

• 无论直接引用Components项目还是其带.pdb的NuGet包，.cs文件的Go to definition功能均正常
• 仅直接引用Components项目时，.xaml文件的Go to definition功能正常

失效场景 #

引用NuGet包而非直接项目且移除原项目后，.xaml中资源字典项的Go to definition功能失效，期望该功能能和.cs文件一样正常工作

已执行操作 #

• 启用XML文档生成进行批量构建
• 使用MSBuild命令生成构建二进制文件：

MSBuild.exe "D:\POC\CommonLibPOC\NugetPOC\NewAppStructurePOC\Components\Components.csproj" -property:Configuration=Debug  -property:Platform="x64" -t:restore -t:clean -t:rebuild /p:DebugSymbols=true /p:DebugType=full

• 通过.nuspec文件打包生成含.pdb的NuGet包：

nuget pack "D:\POC\CommonLibPOC\NugetPOC\NewAppStructurePOC\Components\Components.nuspec" -OutputDirectory D:\POC\CommonLibPOC\NugetPOC\NewAppStructurePOC\Components\bin\x64\Debug  -properties "platform=x64;Configuration=Debug"

解决方案 #

1. 让NuGet包包含XAML源文件和符号信息 #

仅包含.pdb不足以让Visual Studio定位XAML资源定义，需要把原始XAML文件也打包进NuGet包，同时确保符号文件能关联到这些源文件。

修改你的.nuspec文件，添加XAML源文件的包含规则：

<files>
  <!-- 保留原有文件规则 -->
  <file src="bin\$(Configuration)\$(Platform)\*.dll" target="lib\net[你的框架版本]\$(Platform)" />
  <file src="bin\$(Configuration)\$(Platform)\*.pdb" target="lib\net[你的框架版本]\$(Platform)" />
  <!-- 添加XAML源文件 -->
  <file src="**\*.xaml" target="src" />
  <!-- 若有XML文档文件也一并添加 -->
  <file src="bin\$(Configuration)\$(Platform)\*.xml" target="lib\net[你的框架版本]\$(Platform)" />
</files>

src目录会让Visual Studio识别到源文件，配合pdb实现跳转。

2. 生成符号包（.snupkg）增强调试支持 #

除主NuGet包外，生成专门用于提供调试符号和源文件的符号包，能更好支持Visual Studio的Go to Definition功能：

• 在.csproj中添加配置：

  <PropertyGroup>
    <IncludeSymbols>true</IncludeSymbols>
    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
  </PropertyGroup>
  

• 或使用nuget pack时添加-Symbols参数：

  nuget pack [你的nuspec路径] -Symbols -SymbolPackageFormat snupkg [其他参数]
  

将符号包上传到对应NuGet源（本地或公共源），Visual Studio会自动下载关联符号文件。

3. 检查Visual Studio调试符号设置 #

确保Visual Studio已启用符号加载：

• 打开工具 > 选项 > 调试 > 符号
• 勾选Microsoft符号服务器（公共NuGet源场景），或添加本地符号源路径
• 确保启用源服务器支持已勾选

4. 验证NuGet包内容 #

打包完成后，将.nupkg改为.zip解压，检查是否包含：

• lib目录下的dll、pdb、xml文件
• src目录下的所有XAML源文件

若仍有问题，可清理Visual Studio缓存：删除%LOCALAPPDATA%\Microsoft\VisualStudio\[版本号]\ComponentModelCache目录后重启Visual Studio。

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