我之前在调试树莓派计算模块时，也跟你一样在launch.json里踩了一堆连环坑，折腾了好几天才搞定！下面是我亲测有效的完整配置流程，应该能帮你顺利跑通远程调试：

一、先搞定树莓派端的准备工作 #

• 确保树莓派能通过SSH正常连接，先把基础链路打通
• 安装调试必备工具gdbserver：在树莓派终端执行

  sudo apt update && sudo apt install gdbserver
  

• 编译代码时一定要加调试符号！用GCC的话，编译命令必须带-g参数，比如：

  gcc -g your_code.c -o your_program
  

• 先在树莓派本地跑一遍你的程序，确保程序本身能正常运行，排除代码本身的问题

二、VSCode本地端的基础配置 #

• 安装两个核心扩展：
  • Remote - SSH：用来建立和树莓派的远程连接
  • C/C++ Extension Pack：提供C/C++的调试支持
• 用Remote - SSH连接树莓派：点击左侧的「远程资源管理器」，添加SSH连接（格式是pi@你的树莓派IP地址），然后选择连接到该主机，等待VSCode加载完远程环境

三、launch.json的正确配置（重点避坑！） #

这部分是最容易出问题的地方，我给你一个经过验证的模板，你只需要修改几个关键路径即可：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Remote Debug RPi CM",
            "type": "cppdbg",
            "request": "launch",
            "program": "/home/pi/your_program_dir/your_program", // 树莓派上程序的绝对路径！
            "args": [], // 程序运行参数，没有就留空
            "stopAtEntry": false, // 是否在程序入口处暂停，按需设置
            "cwd": "/home/pi/your_program_dir", // 树莓派上程序的工作目录（绝对路径）
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "/usr/bin/gdb", // 本地gdb路径，Linux/macOS一般是这个；Windows要填MinGW/MSYS的gdb.exe路径，比如C:\\mingw64\\bin\\gdb.exe
            "miDebuggerServerAddress": "你的树莓派IP:1234", // 树莓派IP+调试端口，比如192.168.1.100:1234
            "setupCommands": [
                {
                    "description": "开启gdb美化打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "" // 不需要预编译任务就留空
        }
    ]
}

• 几个必须注意的坑：
  • program和cwd必须是树莓派上的绝对路径，绝对不能用相对路径！
  • miDebuggerServerAddress里的端口，要和后面启动gdbserver时用的端口完全一致
  • Windows用户注意miDebuggerPath的路径分隔符是双反斜杠\\

四、启动调试的正确步骤 #

1. 回到树莓派的终端，进入程序所在目录，启动gdbserver：

   gdbserver :1234 ./your_program
   

   这里的1234要和launch.json里的端口完全对应
2. 切换到VSCode，点击调试面板的绿色启动按钮
3. 正常情况下就能连接成功，设置断点开始调试了

五、常见问题快速排查 #

• 连接失败：检查树莓派防火墙是否开放了对应端口，或者临时关闭防火墙试试sudo ufw disable
• 断点打不上：确认编译代码时加了-g参数，生成的程序包含调试符号
• 提示找不到gdb：检查本地miDebuggerPath是否正确，树莓派上的gdbserver是否安装成功

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