VSCode远程调试Python/Node.js应用

VSCode远程调试Python和Node.js的核心是本地编辑器通过调试协议连接远端进程，关键在于路径映射、端口开放与环境一致。Python用debugpy监听0.0.0.0:5678并配置pathMappings；Node.js用--inspect=0.0.0.0:9229或SSH端口转发，配准localRoot与remoteRoot；需确保版本、插件、防火墙及源码可读性。

VSCode远程调试Python和Node.js应用，核心是让本地编辑器连接到远端运行的进程，通过调试协议实时查看变量、单步执行、设断点。关键不在“怎么连”，而在于“连对了没”和“环境是否一致”。

Python远程调试：用debugpy启动服务

推荐使用微软官方维护的debugpy，替代已停更的ptvsd。它支持在远端以监听模式启动Python程序，本地VSCode通过TCP连接接入。

• 远端安装：运行 pip install debugpy
• 远端启动脚本（例如app.py）：
  python -m debugpy --listen 0.0.0.0:5678 --wait-for-client app.py
  注意：--listen地址要设为0.0.0.0（非127.0.0.1），并开放对应端口（如5678）
• 本地VSCode配置.vscode/launch.json：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "name": "Python: Remote Attach",
        "type": "python",
        "request": "attach",
        "connect": {
          "host": "your-remote-ip",
          "port": 5678
        },
        "pathMappings": [
          {
            "localRoot": "${workspaceFolder}",
            "remoteRoot": "/path/on/remote/server"
          }
        ]
      }
    ]
  }

  登录后复制
• pathMappings必须配准——本地代码路径和远端实际路径的映射，否则断点不生效

Node.js远程调试：启用inspect并转发端口

Node.js 8+原生支持--inspect，无需额外工具。重点是让本地VSCode能访问远端的inspect端口（默认9229）。

• 远端启动命令：
  node --inspect=0.0.0.0:9229 app.js
  同样注意绑定0.0.0.0，而非localhost
• 若远端在Docker或云服务器中，需确保防火墙/安全组放行9229端口
  或使用SSH端口转发（更安全）：
  ssh -L 9229:localhost:9229 user@remote-ip
  然后本地配置中host设为localhost，port仍为9229
• VSCode launch.json示例：

  {
    "name": "Node.js: Remote Attach",
    "type": "node",
    "request": "attach",
    "address": "localhost",
    "port": 9229,
    "localRoot": "${workspaceFolder}",
    "remoteRoot": "/home/user/app"
  }

  登录后复制
• 首次连接可能提示“未找到源码”，检查localRoot与remoteRoot是否严格匹配

通用避坑要点

很多调试失败不是配置错，而是环境细节被忽略：

MCP市场

中文MCP工具聚合与分发平台

211

查看详情

立即学习“Python免费学习笔记（深入）”；

• 远端Python/Node版本要和本地开发环境尽量一致，尤其涉及语法特性或调试协议变更时
• VSCode插件必须装对：
  Python调试依赖Python扩展（ms-python.python）；
  Node.js调试依赖Node Debug Auto-Attach（内置）或 JavaScript Debugger
• 断点灰色？常见原因：源码路径映射错误、远端代码被编译/打包过（如TS未生成sourceMap）、文件权限导致VSCode读不到源码
• 调试过程中修改代码不会自动热重载，需手动重启远端进程再重新attach

基本上就这些。远程调试不复杂但容易忽略路径、端口、权限三个关键点。配通一次，后续复用很快。

以上就是VSCode远程调试Python/Node.js应用的详细内容，更多请关注php中文网其它相关文章！