VSCode本身不监听端口，而是通过launch.json配置或Auto Attach机制连接Node.js进程暴露的调试端口（如9229）；关键在于Node启动时需带--inspect或--inspect-brk参数，且VSCode中port、address、protocol等配置必须与之严格匹配，调试端口与业务端口（如3000）完全独立。
直接说结论：VSCode 本身不“监听端口”，它通过调试配置（launch.json）或自动附加（Auto Attach）机制，让本地调试器连接到 Node.js 进程监听的调试端口（如 9229），而不是 HTTP/HTTPS 服务端口（如 3000）。你要的“监听特定端口”，本质是让 Node 进程开启调试端口，并确保 VSCode 能连上它。
Node 进程必须显式暴露调试端口
VSCode 调试依赖 Node 的 V8 Inspector 协议，不是靠抓 HTTP 流量。所以关键不是 server.listen(3000)，而是进程启动时是否带 --inspect 或 --inspect-brk 参数：
-
node --inspect=0.0.0.0:9229 index.js：监听所有 IP 的9229，适用于远程调试或容器内运行 -
node --inspect-brk=127.0.0.1:9229 app.js：只允许本地连接，且启动即暂停（推荐，避免断点错过初始化逻辑） - 不加地址默认绑定
127.0.0.1，在 WSL 或 Docker 中可能连不上——得写0.0.0.0并确认防火墙/安全组放行 - 端口被占用时会报错：
Starting inspector on 127.0.0.1:9229 failed: address already in use，换端口或杀掉旧进程（lsof -i :9229或netstat -ano | findstr :9229）
launch.json 中的 port 和 address 必须匹配 Node 启动参数
如果你用 request: "attach" 模式（比如配合 nodemon），launch.json 里的 port 和 address 得和实际启动命令一致：
- Node 启动为
node --inspect-brk=127.0.0.1:9230 app.js→launch.json中必须设"port": 9230, "address": "127.0.0.1" - 若 Node 绑定
0.0.0.0:9229，但launch.json写"address": "localhost"，在某些网络栈下会失败（localhost≠0.0.0.0） -
"protocol": "inspector"必须显式声明，否则 Node v12+ 可能 fallback 到废弃的legacy协议，导致 VSCode 连不上 - 别填
processId：手动选进程容易选错残留进程，固定端口 +"restart": true更稳
Auto Attach 模式下端口监听由 Node 自动管理
启用 Debug: Toggle Auto Attach 后，VSCode 会在后台监听 9229（默认），但只响应当前工作区下、终端里新启的带 --inspect 的 Node 进程：
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 执行
node --inspect app.js→ VSCode 几秒内自动弹出调试窗口 - 执行
npm start（只要脚本最终调用node --inspect）→ 同样被捕获 - 必须设
"debug.javascript.autoAttachFilter": "smart"，否则会 attach 全局 npm/pnpm/npx 进程，卡死 IDE - 如果项目用
ts-node或老版nodemon，它们可能不透传--inspect参数——升级到nodemon@3.0+或改用npm run debug脚本更可靠
远程调试时端口映射必须双向打通
在 Remote-SSH 场景下，“监听端口”实际依赖 SSH 隧道转发。VSCode 自动处理，但前提是你没手动关掉：
- 远程 Node 启动：
node --inspect=0.0.0.0:9229 server.js - 本地
launch.json中"port": 9229，VSCode 会自动建立反向隧道，把远程9229映射到本地9229 - 如果远程服务器防火墙拦截了
9229，或者 SSH 配置禁用了AllowTcpForwarding，隧道建不起来，VSCode 会报Could not connect to debug adapter - 别在远程手动
ssh -R 9229:localhost:9229 user@host——VSCode Remote-SSH 已内置该逻辑，重复操作反而冲突
真正容易被忽略的是：调试端口和业务端口完全无关。你可以在 3000 上跑 HTTP 服务，同时用 9229 调试它；但如果你改了调试端口（比如用 9230），所有地方——启动命令、launch.json、Auto Attach 的监听配置——都得同步改，漏一个就断连。
