vscode不管理node环境或端口，根本问题是path未正确继承：macos/linux需确保shell初始化文件加载且用login shell启动vscode，windows需重装node并勾选“add to path”或手动添加路径，验证须在vscode终端执行node -v和npm -v。
VSCode 本身不管理 Node 环境或端口，它只负责启动调试进程并连接——端口由你的代码（如 app.listen(3000)）或调试配置显式指定；环境变量和 PATH 才是能否启动的关键。配错端口不会导致调试失败，但会掩盖真实问题。
node 命令在 VSCode 终端里报 command not found
这不是插件或 launch.json 的问题，是 VSCode 启动时没加载 shell 初始化文件（比如 ~/.zshrc），导致 PATH 里没有 node。
- macOS/Linux：检查
~/.zshrc是否含export PATH="/opt/homebrew/bin:$PATH"（Homebrew 安装路径）或/usr/local/bin；改完后运行source ~/.zshrc，再用该终端执行code .启动 VSCode - Windows：重装 Node.js，必须勾选 “Add to PATH”；或手动把
C:\Program Files\nodejs\加进系统环境变量的Path - VSCode 必须彻底退出所有进程再重开——仅关窗口或重启终端无效
- 验证方式：打开 VSCode 内置终端（
Ctrl + `），执行node -v和npm -v，必须有输出
launch.json 中 program 指向正确但端口不生效
端口是否监听，完全取决于你代码里怎么写的 listen()，launch.json 不控制这个。但如果你用了 --inspect 调试协议，端口冲突会导致调试器连不上。
-
launch.json的port字段（如"port": 9229）仅用于调试器连接 Chrome DevTools 协议，和 HTTP 服务端口无关 - HTTP 端口由代码决定：
app.listen(4000)就监听 4000，和调试端口互不影响；但若两个服务都试图绑定3000，后者会报EADDRINUSE - 想让调试器自动附加到已启动的服务，用
attach模式，并确保代码启动时加了--inspect=9229参数 - ESM 项目需在
package.json中设"type": "module"，否则import解析失败，服务根本起不来，端口自然没响应
nodemon 调试时端口反复变化或断连
直接把 program 设成 nodemon 脚本会导致调试器无法稳定 attach——因为 nodemon 会杀掉旧进程、拉起新进程，而调试器只连了一次。
- 别写
"program": "${workspaceFolder}/node_modules/.bin/nodemon" - 改用
runtimeExecutable+runtimeArgs："runtimeExecutable": "npx","runtimeArgs": ["nodemon", "--inspect-brk", "${workspaceFolder}/src/index.js"] -
--inspect-brk让进程在第一行暂停，确保调试器能接上；去掉-brk就可能错过断点 - 如果 nodemon 自动重启后断点失效，检查
sourceMap是否生成且路径正确——.js.map必须和.js在同一目录
真正卡住人的从来不是端口号填多少，而是 node 命令根本没加载、program 指向一个不存在的 .js 文件、或者 ESM/CommonJS 混用导致 require 或 import 报错——这些错误不会提示“端口失败”，只会静默跳过监听逻辑。
