如何在VS Code中远程调试树莓派上的Python脚本

可以远程调试树莓派上的Python脚本，按照以下步骤操作即可解决调试无反应的问题：

1. 在树莓派上安装调试依赖 #

通过VS Code的SSH连接终端，执行以下命令安装debugpy（VS Code Python扩展官方推荐的调试工具）：

pip3 install debugpy

2. 配置VS Code调试文件 #

• 点击左侧调试面板（虫子图标），选择创建launch.json文件，在弹出的环境选择中选Python。
• 将默认生成的launch.json替换为以下配置：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Remote Debug Raspberry Pi",
              "type": "python",
              "request": "attach",
              "connect": {
                  "host": "localhost",
                  "port": 5678
              },
              "pathMappings": [
                  {
                      "localRoot": "${workspaceFolder}",
                      "remoteRoot": "${workspaceFolder}"
                  }
              ],
              "justMyCode": true
          }
      ]
  }
  

  说明：pathMappings确保本地与远程的代码目录路径一致，SSH连接后VS Code的${workspaceFolder}已对应树莓派上的工作目录，无需额外修改。

3. 启动调试流程 #

• 在需要调试的Python脚本开头添加以下代码，让脚本等待调试器连接：

  import debugpy
  # 监听所有网络接口的5678端口
  debugpy.listen(("0.0.0.0", 5678))
  print("等待调试器连接，请在VS Code中启动调试...")
  debugpy.wait_for_client()
  

• 在VS Code的远程终端中运行脚本：

  python3 your_script.py
  

• 回到调试面板，选择刚才配置的Remote Debug Raspberry Pi，点击启动调试按钮（绿色三角）。此时脚本会继续执行，你可以在代码中设置断点、查看变量等，和本地调试完全一致。

注意事项 #

• 如果调试仍无反应，检查树莓派上的debugpy是否安装成功，可通过pip3 show debugpy验证。
• 确保脚本中没有阻塞debugpy.wait_for_client()执行的代码。

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