VSCode终端报“node不是内部或外部命令”根本原因是进程未继承更新后的PATH：Windows需重装Node时勾选Add toPATH并彻底重启VSCode；macOS/Linux需从终端执行code .启动以加载shell配置；npm全局命令失效则需将npm prefix路径加入PATH并全进程重启。

node

命令在 VSCode 终端里报 “不是内部或外部命令”，说明集成终端根本没拿到 Node.js 路径——这不是插件问题，也不是 VSCode 设置错，而是环境变量没继承到位。解决它不靠改配置文件，靠确认安装动作和启动方式。

Windows 下 node -v 在 CMD 成功但 VSCode 终端失败

根本原因是 VSCode 进程启动时没加载更新后的系统 PATH。哪怕你刚装完 Node.js 并勾选了 “Add to PATH”，已运行的 VSCode 不会自动刷新环境变量。

• 重装 Node.js 时务必勾选 “Add to PATH”（MSI 安装器默认不勾，跳过就白装）
• 安装完成后，必须彻底关闭所有 VSCode 实例（包括后台进程），再重新打开 —— 只关窗口不够，任务栏右键退出或用任务管理器杀掉 Code.exe
• 验证：重启后，在 VSCode 内置终端（Ctrl + `）中直接运行 node -v；如果仍失败，去「系统属性 → 高级 → 环境变量」检查 C:\Program Files\nodejs\ 是否在「系统变量」的 PATH 中

macOS/Linux 下 which node 有输出但 VSCode 终端找不到

VSCode 没读取 shell 初始化文件（如 ~/.zshrc），导致 PATH 里缺了 Node.js 实际路径（比如 /opt/homebrew/bin/node）。

• 先在系统终端运行 which node，记下返回路径
• 确认该路径已加进 shell 配置文件末尾，例如：export PATH="/opt/homebrew/bin:$PATH"
• 不要只改完配置就 Ctrl+Shift+P → “重新加载窗口”，这不会重载 shell 环境；必须完全退出 VSCode，再从系统终端执行 code . 启动（这样它才能继承当前 shell 的完整环境）

终端能跑 node，但 npm install -g 全局命令找不到

全局模块（如 nodemon、http-server）安装后不可用，大概率是 npm 全局 bin 目录没进 PATH。

用于自动切换项目中适合的node 版本

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载

• 运行 npm config get prefix 查看全局路径（默认是 C:\Users\XXX\AppData\Roaming\npm 或 /usr/local）
• 把这个路径手动加进系统或用户环境变量的 PATH（Windows）或 shell 配置（macOS/Linux）
• 加完必须重启 VSCode 全进程，仅重启终端无效
• 验证：新开 VSCode 终端，运行 nodemon -v 或 http-server -h

用 code-runner 执行 JS 却卡死/乱码/不支持 import

这个插件默认用 node $fileName，不处理编码、模块类型、标准输入流，属于“能跑但不稳”的方案。

• 中文乱码：在 VSCode 设置里搜 code-runner.executorMap，把 javascript 对应值改成："node -r utf-8 $fileName"
• ESM 报 Cannot use import statement outside a module：确保项目根目录 package.json 有 "type": "module"，再把 executor 改成："node --experimental-specifier-resolution=node $fileName"
• 含 process.stdin 就假死：code-runner 不支持交互式输入，要么换到内置终端手动运行，要么用 F5 调试（它会接管 stdin）

真正卡住人的从来不是“怎么配”，而是“为什么重开终端没用”“为什么改了 PATH 还是找不到”。环境变量不是写完就生效的配置项，它是进程启动时的一次性快照——VSCode 必须作为新进程启动，才能拿到最新 PATH。这点容易被忽略，但绕不开。