You need to enable JavaScript to run this app. 如何将Windows下VSCode C++调试器附加到Embarcadero项目并解决符号加载问题
优惠活动
大模型
产品
解决方案
定价
更多

如何将Windows下VSCode C++调试器附加到Embarcadero项目并解决符号加载问题

Embarcadero Delphi/C++ 遗留项目 VSCode 调试适配方案

调试器附加可行性

  • 不存在平台限制,完全可以通过VSCode实现对该类项目的进程附加调试,不需要完全依赖RAD Studio自带调试器完成断点调试。
  • 核心限制点:Embarcadero工具链生成的调试符号为Turbo Debugger专有格式,不是通用PE/PDB标准格式,普通VSCode内置C/C++扩展默认无法解析这类符号。

"No symbols have been loaded for this document" 问题根源

  • 不是简单的symbolSearchPath为空导致的:RAD Studio调试时不需要手动填符号路径,是因为它内置的调试器会自动从可执行文件同目录、编译缓存路径加载专有TDS符号,和通用VSCode调试器的符号加载逻辑完全不同。
  • 第一类核心问题:VSCode当前使用的调试器后端不支持Embarcadero的TDS符号格式,哪怕符号文件就在本地,也无法解析关联源码断点。
  • 第二类常见问题:启动调试时的工作目录、可执行文件路径配置不匹配,调试器无法建立源码文件和已加载模块的映射关系,直接判定当前文档没有对应符号。
  • 第三类容易忽略的问题:项目编译时未开启全量调试符号开关,Release配置下的符号已被裁剪剥离,RAD Studio端调试时加载的是本地缓存的符号副本,VSCode端无法访问这类缓存路径。

符号文件路径查找与配置步骤

  • 明确符号文件的存储规则:
    • 默认配置下,Embarcadero工具链会把完整调试符号直接嵌入生成的EXE/DLL文件的专属数据段,不会单独生成独立符号文件
    • 只有开启“分离调试符号”配置时,才会生成和可执行文件同名、后缀为.tds的独立符号文件,默认输出路径和对应EXE/DLL完全一致
  • 快速定位符号路径的操作:
    • 在RAD Studio中打开项目的编译配置页,查看目标编译模式下的可执行文件输出路径
    • 直接进入该输出目录,和EXE/DLL同路径下的所有.tds文件、EXE/DLL本身,就是完整的调试符号存储位置
  • VSCode调试配置必填项:
    • 替换默认调试器后端,安装适配Embarcadero工具链的VSCode调试扩展,支持TDS符号解析
    • 在launch.json中设置cwd为可执行文件所在目录,避免工作目录不匹配导致的源码映射失效
    • 手动将定位到的符号所在目录填入symbolSearchPath字段,不要留空
    • 确认项目编译配置打开Include debug info、Generate td32 debug info两个开关,关闭Strip debug symbols选项

注意:Delphi与C混合编译的项目,需要分别确认Delphi单元、C编译单元的符号都被完整加载,仅配置C++模块的符号路径会导致Delphi源码断点依然报无符号错误。

内容的提问来源于stack exchange,提问作者KapitaiN

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 11:15:04