VSCode调试Rust时如何进入C源码进行调试？

1. 确保C静态库带调试信息编译 #

编译C库时必须添加-g参数生成调试信息，否则调试器无法关联源码：

• 编译C源文件为目标文件：

  gcc -g -c my_lib.c -o my_lib.o
  

• 打包为静态库：

  ar rcs libmy_lib.a my_lib.o
  

如果用Makefile构建C库，要在CFLAGS中加入-g，确保所有编译单元都包含调试信息。

2. 确保Rust项目以Debug模式编译 #

Rust的Debug模式默认生成包含完整调试信息的可执行文件，直接用以下命令构建：

cargo build

不要使用cargo build --release，Release模式会剥离调试信息并做优化，无法正常调试。

3. 修改VSCode的launch.json配置 #

需要添加源码路径映射，让gdb能找到本地C源码，同时确保调试器加载完整符号：
修改后的launch.json示例：

{
    "name": "my_app_debug",
    "type": "cppdbg",
    "request": "launch",
    "program": "${workspaceFolder}/target/debug/my_app",
    "args": [],
    "stopAtEntry": false,
    "cwd": "${workspaceFolder}",
    "environment": [],
    "externalConsole": false,
    "miDebuggerPath": "/usr/bin/gdb",
    "MIMode": "gdb",
    "setupCommands": [
        {
            "text": "-enable-pretty-printing",
            "ignoreFailures": true
        },
        // 映射C源码路径：将编译C库时的原始路径替换为本地源码路径
        {
            "text": "-gdb-set substitute-path /path/used/when/compiling/c_lib ${workspaceFolder}/path/to/local/c_src",
            "ignoreFailures": false
        }
    ],
    // 可选：直接指定源码搜索目录
    "sourceFileMap": {
        "/path/used/when/compiling/c_lib": "${workspaceFolder}/path/to/local/c_src"
    }
}

注意：

• program字段要指向Rust项目Debug模式生成的可执行文件，通常在target/debug目录下
• /path/used/when/compiling/c_lib是编译C库时gdb记录的源码路径（可通过gdb命令info sources查看），替换为你本地C源码的实际路径

4. 调试操作注意事项 #

• 在Rust代码中unsafe { some_c_function(3) }行添加断点
• 触发断点后，使用**步进进入（Step Into）**操作（VSCode快捷键F11），即可进入C函数源码调试

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