VSCode中node命令报“command not found”根本原因是未继承终端环境：macOS/Linux因~/.zshrc未加载导致PATH缺失，Windows因安装时未勾选“Add to PATH”；需验证which node或where node路径，macOS/Linux用code .启动或重载窗口，Windows重装Node并勾选添加PATH，调试器找不到node则需检查launch.json的runtimeExecutable配置。
VSCode 里 node 命令报 command not found 怎么办
根本不是 VS Code 配置错了，而是它没继承你终端里已有的 node 环境。Mac/Linux 用户常因 Shell 初始化文件（如 ~/.zshrc）里配置了 PATH，但 VS Code 启动时没加载它；Windows 用户则多因安装 Node.js 时没勾选 “Add to PATH”。
先在终端里运行 which node（Mac/Linux）或 where node（Windows），确认路径是否真实存在：
- Mac/Linux：按
Cmd+Shift+P→ 输入Developer: Reload Window，强制重载窗口并读取最新 Shell 环境；如果仍不行，直接从终端启动 VS Code：code . - Windows：重装 Node.js，务必勾选 “Add to PATH”；若已安装，手动把 Node.js 安装目录（如
C:\Program Files\nodejs\）加到系统环境变量PATH中
调试时提示 Cannot find runtime 'node' 或断点不生效
这是 VS Code 的调试器找不到 Node.js 运行时，和终端能跑 node 是两回事——调试器依赖 launch.json 里的 runtimeExecutable 或全局 PATH。
检查项目根目录下是否有 .vscode/launch.json，里面 configurations 是否写了 "runtimeExecutable": "/path/to/node"：
- 没写这行就删掉它，让调试器走默认查找逻辑
- 如果用了
nvm/fnm/volta等版本管理工具，调试器默认不识别切换逻辑；稳妥做法是在launch.json中显式指定路径，比如"runtimeExecutable": "~/.nvm/versions/node/v18.17.0/bin/node" - 断点不生效常见于用
ts-node或esbuild-node启动 TypeScript 文件，此时应改用node --loader ts-node/esm模式，并在launch.json中配"runtimeArgs"
自动补全、跳转、类型提示失效（即使 node 能运行）
这不是 Node.js 环境问题，是 VS Code 没识别出项目是 Node.js 项目，或没加载正确的语言服务。TypeScript 和 JavaScript 的智能提示依赖 jsconfig.json 或 tsconfig.json。
必须满足以下任一条件，否则 JS/TS 文件不会被纳入语言服务：
- 项目根目录有
jsconfig.json，且含"type": "module"或"compilerOptions": {"allowJs": true} - 项目根目录有
tsconfig.json，哪怕只是空对象{} - 禁用所有非必要插件，尤其那些宣称“增强 JS 支持”的第三方插件——VS Code 内置的 JavaScript and TypeScript 语言功能已足够，插件冲突反而导致跳转失败
热插拔插件实际不可靠，别指望它自动修复环境链
所谓“热插拔 Node 插件”（比如 Node.js Extension Pack、Code Runner）本质是快捷入口，它们不参与环境变量加载、不接管 PATH 查找、也不影响调试器的运行时定位逻辑。装了 ≠ 环境就通了。
真正起作用的只有三件事：Shell 环境是否被 VS Code 继承、launch.json 是否显式指定了 runtimeExecutable、项目是否有合法的 jsconfig.json 或 tsconfig.json。其余插件只负责代码高亮、右键运行、格式化等边缘功能，一旦底层环境链断开，它们连报错都报不准。
最易被忽略的是：reload window 不等于 source ~/.zshrc，而从桌面图标启动的 VS Code 在 macOS 上几乎永远读不到你的 Shell 配置——除非你用终端启动它。
