如何在VSCode中使用cppvsdbg调试器步入Rust标准库源码？

要实现用cppvsdbg调试Rust时步入标准库源码，需要完成以下几个关键步骤：

1. 准备带调试信息的Rust标准库 #

默认预编译的Rust标准库调试信息不全，首先要安装源码并确保编译时生成完整调试符号：

• 执行 rustup component add rust-src 安装Rust标准库源码到本地工具链目录
• 配置编译参数，确保生成完整调试信息：
  可以临时设置环境变量 RUSTFLAGS="-C debuginfo=full"，或者在项目根目录的.cargo/config.toml中添加永久配置：

  [build]
  rustflags = ["-C", "debuginfo=full"]
  

2. 配置VSCode的调试启动项 #

修改或创建.vscode/launch.json，针对cppvsdbg调试器进行以下配置：

• 关闭justMyCode选项，允许调试非用户代码
• 设置sourceFileMap，将调试器识别的标准库源码路径映射到本地rust-src的实际路径

示例配置如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Rust Debug (cppvsdbg)",
            "type": "cppvsdbg",
            "request": "launch",
            "program": "${workspaceFolder}/target/debug/${workspaceFolderBasename}",
            "args": [],
            "cwd": "${workspaceFolder}",
            "externalConsole": false,
            "justMyCode": false,
            "sourceFileMap": {
                "/rustc/<rustc-commit-hash>": "${env:USERPROFILE}/.rustup/toolchains/<your-toolchain>/lib/rustlib/src/rust/library"
            }
        }
    ]
}

其中：

• <rustc-commit-hash> 可以通过rustc --version获取，比如输出rustc 1.75.0 (82e1608df 2023-12-21)中的82e1608df就是哈希值
• <your-toolchain> 是当前使用的Rust工具链名称，比如stable-x86_64-pc-windows-msvc，可以通过rustup show查看

3. 启动调试并步入标准库 #

• 确保项目以Debug模式编译（执行cargo build即可，默认是Debug）
• 在代码中设置断点，启动调试会话
• 当程序执行到调用标准库函数的位置时，点击调试面板的"步入"（Step Into）按钮，就能进入标准库的源码文件进行调试

注意事项 #

• 确保VSCode的C/C++插件和cppvsdbg调试器是最新版本，避免兼容性问题
• 若出现找不到源码的情况，检查sourceFileMap中的路径是否与本地rust-src的实际路径一致
• 部分标准库核心函数采用汇编或内置实现，这类函数无法步入，属于正常现象

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