Visual Studio Package开发中能否在调试时步入Roslyn源代码
自研VS Package调试时步入Roslyn源码的实现方法
核心前提
在你已获取Roslyn完整本地源码的基础上,实现单步入执行的核心逻辑是确保调试时加载的PDB调试符号,和运行时实际加载的Roslyn程序集版本完全匹配,同时关闭VS默认开启的“跳过非用户编写的框架代码”调试限制。
必选基础调试配置
- 打开VS设置面板,依次进入
工具 -> 选项 -> 调试 -> 常规 - 取消勾选“仅启用我的代码”选项
- 勾选“启用源服务器支持”“启用源链接支持”
- 取消勾选“要求源文件与原始版本完全匹配”,避免因源码和符号存在小版本差异导致断点直接失效
两种符号加载实现路径
路径1:使用官方公开发布的调试符号(无Roslyn自定义修改时优先选)
- 在同设置面板的“符号”标签页,勾选“Microsoft Symbol Servers”
- 指定一个本地有写入权限的文件夹作为符号缓存存储路径
- 启动你的VS Package项目进入调试状态,当代码执行到调用Roslyn API的断点位置时,VS会自动匹配下载对应版本的PDB符号,直接跳转至Roslyn源码界面支持单步调试
- 此方案无需手动编译本地Roslyn源码,配置成本最低
路径2:关联本地编译的Roslyn符号(适配自定义修改Roslyn逻辑的场景)
- 将本地拉取的Roslyn源码切换到与当前VS加载的Roslyn程序集版本完全一致的commit节点,完成本地编译,生成全量配套PDB文件
- 在VS的“符号”设置页,新增符号搜索路径,指向本地编译生成的Roslyn PDB存放目录
- 手动替换VS环境中同版本的Roslyn程序集文件,操作前务必备份原文件,避免破坏宿主VS的运行稳定性
- 在“源文件”设置页,添加本地Roslyn源码的根目录到搜索路径列表,确保VS能定位到对应源码文件
常见调试失效排查
- 单步步入直接跳转到反汇编界面:打开调试状态下的“模块”窗口,找到对应的
Microsoft.CodeAnalysis.*程序集,右键选择“加载符号”,手动指定匹配版本的PDB文件 - 断点显示空心状态:核对当前VS实际加载的Roslyn程序集版本,若与本地源码版本差超过小版本区间,需要重新对齐源码的分支和commit节点
内容的提问来源于stack exchange,提问作者Phil Jollans
相关产品推荐
相关产品推荐

