VSCode attach模式连不上本地Node进程，根本原因是进程未启动--inspect参数、端口/地址配置不匹配或防火墙拦截。必须确保node --inspect-brk启动、launch.json中type为"node"、request为"attach"、port和address与实际一致，并排除源码映射、ESM兼容性及code-runner误用等问题。
VSCode 里“断开本地连接”不是标准术语，你实际遇到的很可能是调试器连不上 Node 进程——比如断点不触发、Debug Console 空白、提示 Connection refused 或 Timeout waiting for connection。根本原因几乎总是 attach 模式配置错、端口没对上，或进程根本没启动带 --inspect 参数。
为什么 attach 模式总连不上本地 Node 进程
VSCode 的 attach 不是“自动发现进程”，它必须精确匹配进程启动时暴露的调试端口和地址。常见失效场景：
- 你在终端手动执行了
node app.js（没加--inspect），VSCode 却用request: "attach"去连——这相当于往空房间敲门 - 启动命令用了
--inspect=0.0.0.0:9230，但launch.json里写的是"port": 9229，端口不一致直接拒绝连接 - Node 进程启动后立刻退出（比如
require报错、process.exit()），VSCode 来不及附加就断连 - Windows 上开了防火墙，或 macOS 启用了“阻止来自互联网的连接”，
localhost被拦截（少见但真实存在）
正确配 attach：三步缺一不可
确保你手动启动的进程和 VSCode 配置完全对齐：
- 终端里先跑：
node --inspect-brk ./src/server.js（--inspect-brk让进程停在第一行，留出连接窗口） -
launch.json中必须含："type": "node"、"request": "attach"、"port": 9229（若启动时指定了其他端口，比如--inspect=9230，这里必须同步改） - 加
"address": "localhost"（显式声明，避免 Docker 或 WSL 场景下默认解析成127.0.0.1导致跨网络失败）
示例最小可用配置：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
{
"configurations": [
{
"type": "node",
"request": "attach",
"name": "Attach to Process",
"port": 9229,
"address": "localhost",
"skipFiles": ["<node_internals>/**"]
}
]
}
常见连不上但你以为连上了的假象
VSCode 有时会显示 “Debugger attached” 却不响应断点，其实是连上了，但源码映射或运行时环境不匹配：
- 进程是 ESM 模块（
package.json有"type": "module"），但调试器按 CommonJS 解析，import失败导致脚本提前终止——检查 Debug Console 是否有Cannot use import statement outside a module - TypeScript 编译产物没生成
.map文件，或outFiles路径没覆盖到实际 JS 输出目录，断点打在 TS 上，调试器找不到对应 JS 行 - 你启用了
autoAttachChildProcesses: true，但子进程（如child_process.fork()）没传--inspect参数，VSCode 尝试连不存在的端口，超时后静默放弃
别用 code-runner 插件替代调试器
很多人图省事，在右键菜单选 “Run Code” 执行 Node 文件，这本质是调用 node xxx.js，不带任何调试协议——断点永远无效。VSCode 内置调试器和 code-runner 是两套完全独立的机制，后者不走 launch.json，也不支持 attach。真要调试，必须走 Ctrl+Shift+D → 选配置 → 按 F5 启动调试会话。
最易被忽略的点：attach 前必须确认进程已启动且稳定监听指定端口，而不是靠 VSCode 去“找”它；端口、地址、协议版本（Node ≥14）三者只要一个不匹配，连接就彻底失败，没有中间状态。
