vscode 不需要额外安装 node.js 插件，因其自 1.40 版起已内置调试器；装 debugger for node.js 或 node.js extension pack 反易导致冲突、断点失效或 runtime 错误。
VSCode 不需要额外安装 Node.js 插件来运行或调试 Node.js 代码——它自带完整支持，装了反而容易冲突。
Debugger for Node.js 或 Node.js Extension Pack 别装
这两个插件已过时。VSCode 自 1.40 版起就内置了 node 调试器，底层直接调用系统 node 进程。装了旧插件可能导致：
-
Cannot find runtime 'node'错误（实际是 PATH 没配好，却被误判为插件问题） - 断点失效、源码映射错乱（尤其在多 Node 版本共存时）
- 调试启动慢、
launch.json配置被插件覆盖重写
真正要检查的是 launch.json 的 program 和 runtimeExecutable
默认生成的 launch.json 里 "program": "${file}" 只适合单文件调试。真实项目中必须按需调整：
- 调试
npm start：把"program"改成"npm"，加"args": ["start"]和"console": "integratedTerminal" - 用
nodemon热重载：不能直接"program": "nodemon"，必须先命令行执行nodemon --inspect-brk index.js，再在launch.json中设"type": "node"、"request": "attach"、"port": 9229 - 多 Node 版本共存（如 nvm）：显式指定
"runtimeExecutable": "/Users/xxx/.nvm/versions/node/v20.15.0/bin/node"，否则 VSCode 可能调用错版本
ESLint 和 Prettier 插件可以装，但规则必须对齐
它们不是 Node 环境必需项，但若启用，必须避免冲突：
- 禁用 Prettier 的自动修复（
"prettier.enable": false），改用 ESLint 的source.fixAll.eslint统一处理 - 确保项目根目录有
.eslintrc.cjs或.eslintrc.js，且包含"env": {"node": true} - 不要让 Prettier 格式化
package.json或node_modules，否则npm install可能静默失败
最常被忽略的一点：VSCode 内置终端是否真正继承了 shell 的环境变量。哪怕 node -v 在系统终端成功，VSCode 里仍可能报错——这时不是插件问题，而是它没读取你的 ~/.zshrc 或 ~/.bash_profile。重启 VSCode 或手动在终端里执行 source ~/.zshrc 才能暴露真实状态。
