Node.js已安装但VSCode终端报“command not found”，根本原因是VSCode未继承shell环境变量：macOS/Linux需设terminal.integrated.shellArgs为["-l"]启用登录shell，Windows应手动将Node路径加入系统PATH并彻底重启VSCode进程。

node -v 在系统终端能跑，但在 VSCode 终端报 command not found

这说明 Node.js 已安装，但 VSCode 没继承到最新环境变量。不是插件问题，也不是 VSCode 坏了——是进程没刷新。

• 完全退出 VSCode：macOS 在 Dock 右键选「退出」，Windows 在任务管理器里确认 Code.exe 进程已结束（别只关窗口）
• 新开一个系统终端（不是 VSCode 里的），执行 which node（macOS/Linux）或 where node（Windows），确认路径指向你装的 Node.js（如 C:\Program Files\nodejs\node.exe）
• 再打开 VSCode，按 Ctrl+` 启动内置终端，立刻跑 node -v —— 这次的结果才代表它真能用

launch.json 里 program 字段写成 "app.js" 就调试失败

VSCode 调试器不会自动猜你当前在编辑哪个文件。写死文件名等于锁死入口，换文件就得改配置。

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

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

下载

• 新建项目后，按 Ctrl+Shift+P 输入 Debug: Open Configuration，选 Node.js → Current File
• 生成的 launch.json 里会是 "program": "${file}"，意思是“运行当前打开的 JS 文件”
• 如果想固定用 index.js 作为入口，改成 "program": "${workspaceFolder}/index.js"，但必须确保该文件存在且已保存
• 调试前务必手动保存文件（Ctrl+S），VSCode 默认不自动保存未修改的文件

装了 Node.js 插件却 run 不起来，还报 require is not defined

所有叫 “Node.js Extension Pack” 或 “Debugger for Node.js” 的插件都不提供 node 运行时——它们只是语法高亮、断点支持、代码片段，不是 Node 本身。

• 去 nodejs.org 下载 LTS 版（当前是 v20.15.1），**手动安装**，安装时勾选 Add to PATH
• 别信 “VSCode 插件能装 node”，那是误导；VSCode 是编辑器，不是运行环境
• 验证方式只有两个命令：node -v 和 npm -v，两者都成功才算环境通了
• 新手第一行代码别写 http.createServer，先写 console.log('ok')，跑通再加逻辑

npm install nodemon 总卡住，或者装完提示 command not found

国内直连 npm 官方源经常超时，而且全局工具默认装在系统盘，容易被权限或路径干扰。

• 换镜像：npm config set registry https://registry.npmmirror.com
• 改全局路径（避免 C 盘满）：npm config set prefix "D:\npm-global"，再把该路径加进系统 PATH
• 重装工具：npm install -g nodemon，之后就能在任意目录用 nodemon index.js
• 如果系统终端能用 nodemon，但 VSCode 里不行，重启 VSCode 或在内置终端里手动执行 source ~/.zshrc（macOS/Linux）

真正卡住的地方从来不是配置项怎么填，而是你敲 node -v 时看到的那行版本号，到底是不是 VSCode 内置终端认的。