根本原因是vs code未继承终端的node.js环境：mac/linux因shell初始化文件未加载，windows因node.js安装时未勾选“add to path”；需分别通过重载窗口、终端启动、重装或手动配置path解决。
VS Code 里 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：在 VS Code 中按
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。
- 确保项目根目录有
package.json，且含"type": "module"或"type": "commonjs"字段（否则模块解析可能错乱） - 新建
jsconfig.json（JS 项目）或tsconfig.json（TS 项目），至少包含{"compilerOptions": {"allowJs": true}}，否则 JS 文件不被纳入语言服务 - 禁用所有非必要插件，尤其那些宣称“增强 JS 支持”的第三方插件——VS Code 内置的
JavaScript and TypeScript语言功能已足够，插件冲突反而导致跳转失败
终端里 npm 正常，但任务运行（Tasks）失败
VS Code 的任务系统默认使用集成终端的 Shell，但它可能用的是不同 Shell（比如 VS Code 默认用 zsh，而你平时用 bash），导致 PATH 不一致，npm 找不到。
- 打开
settings.json（Cmd+, → Open Settings (JSON)），添加："terminal.integrated.defaultProfile.osx": "zsh"（对应你的实际 Shell） - 在
.vscode/tasks.json中，避免写死"shell": "bash"；改用"type": "shell"+"command": "npm run dev"，让任务复用当前终端环境 - 如果任务涉及
npx，注意它依赖node_modules/.bin，确保任务工作目录（"options": {"cwd": "${workspaceFolder}"}）正确，否则会提示command not found
最麻烦的其实是 Node.js 版本混用：终端用 v18，调试器用 v20，任务又悄悄调了 v16。别指望一个设置全局生效，每个环节（终端、调试器、任务、语言服务）都得单独确认版本和路径。盯住 process.version 和 which node，比看文档管用。
