远程调试node.js失败主因是--inspect绑定地址、端口映射或pathmappings配置错误；需用--inspect=0.0.0.0:9229监听所有接口，docker加-p映射，云服务器放行安全组，vscode中address、remoteroot、localroot路径严格一致，并验证http://:9229/json可访问。

远程调试 Node.js 服务能直接在真实环境里设断点、查变量，但连不上或断点不命中，八成是 --inspect 绑定地址、端口映射或 pathMappings 配置错了——不是 VSCode 不行，是它根本没找到对的代码位置。

Node.js 远程启动必须用 --inspect=0.0.0.0:9229

本地开发常用 node --inspect index.js，这默认只监听 127.0.0.1，远程根本连不上。远端启动时必须显式指定监听所有接口：

• node --inspect=0.0.0.0:9229 app.js（注意等号不能省，0.0.0.0 不能写成 localhost 或服务器公网 IP）
• 如果服务跑在 Docker 容器里，还要加 -p 9229:9229 并确认容器内防火墙没拦截
• 云服务器（如阿里云、腾讯云）需在安全组放行 9229 端口，仅开放给你的本地 IP 更安全
• 启动后检查输出：应有类似 Debugger listening on ws://0.0.0.0:9229/...；若只有 127.0.0.1，说明配置无效

launch.json 的 address 和 remoteRoot 必须严格匹配

VSCode 不会自动猜路径。你本地打开的项目目录、远端实际运行的代码路径、以及 remoteRoot 值三者必须一致，否则断点永远灰色。

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

• address 填服务器公网 IP 或域名（不要带端口），例如 "address": "47.98.x.x"
• remoteRoot 是远端代码的绝对路径，比如 /home/user/project/src，不是相对路径，也不是 ~/project
• localRoot 通常用 "${workspaceFolder}"，但要确认你当前 VSCode 打开的就是该目录，而不是父级或子目录
• 常见错误：remoteRoot 少写了 /src，或远端用了软链接而本地没同步，导致文件 hash 不匹配，断点失效

别忽略 Node.js 版本与 protocol 兼容性

Node.js 8.0+ 原生支持 V8 Inspector 协议，但旧版 VSCode 插件可能默认用 legacy 协议，导致连接失败或无法读取变量。

• 确保 VSCode 安装了最新版 JavaScript Debugger（已内置，无需额外插件）
• 在 launch.json 的 attach 配置中显式加上 "protocol": "inspector"
• 如果用的是 Node.js vscode-node-debug2 插件，并改用 "protocol": "legacy"
• 执行 node -v 确认远端版本；本地 VSCode 调试器版本无关紧要，关键看远端 Node 是否支持 inspector

最常被跳过的环节是验证远端调试服务是否真正可访问：在本地浏览器打开 http://<your-server-ip>:9229/json</your-server-ip>，能看到 JSON 列表才算通。如果页面空白或超时，问题一定出在绑定地址、防火墙或反向代理（如 Nginx）拦截了 9229 端口——这时候再调 launch.json 就是白忙。