先检查PATH和安装选项：Windows安装MSI包时必须勾选“Add Node.js to PATH”，macOS手动解压需自行将bin路径加入~/.zshrc；验证须先在系统终端运行node -v和npm -v。

node -v 命令报“未识别”？先检查 PATH 和安装选项

VSCode 里跑不起来 node，根本原因八成是系统压根没认出 Node.js。不是 VSCode 的问题，而是安装时漏掉了关键一步。

• Windows 安装 MSI 包时，必须勾选 Add Node.js to PATH，否则 node 和 npm 只在安装目录里存在，终端找不到
• macOS 用 brew install node 通常没问题；但若手动解压 tar.xz，得自己把 bin 路径加进 ~/.zshrc 或 ~/.bash_profile
• 验证方式不是只在 VSCode 终端里试，而要先在系统终端（如 Windows Terminal、iTerm2）运行 node -v 和 npm -v —— 这步通了，VSCode 才可能通

tasks.json 配置 npm 脚本时 command 字段写什么？

command 不是写 npm run dev 就完事，它取决于你用的是 shell 还是 process 模式，以及是否想复用 package.json 中的脚本。

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

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

下载

• 推荐设为 "type": "shell"，这样 command 直接写完整命令，比如 "npm run start" 或 "npx ts-node src/index.ts"
• 如果设 "type": "process"，command 必须是可执行文件路径，比如 "./node_modules/.bin/nodemon"，不能带参数 —— 参数得塞进 args 数组里
• 别把 npm 写成绝对路径（如 C:\Program Files\nodejs\npm.cmd），跨机器/跨系统就废了；依赖环境变量更可靠

如何让保存文件后自动运行 lint 或 build？

VSCode 本身不支持“保存即执行任意任务”，但可以通过 runOptions + 扩展组合实现，关键是别误以为开个开关就能全自动。

• 在 tasks.json 的 task 里加 "runOptions": { "runOn": "folderOpen" }，只在打开项目时跑一次，不是保存触发
• 真正实现“保存即 lint”，得靠 eslint 扩展配合设置："editor.codeActionsOnSave": { "source.fixAll.eslint": true }，这属于编辑器行为，不是任务系统
• 若真要保存后跑自定义构建任务，需安装扩展如 Auto Run Command 或 Trigger Task on Save，再绑定到具体 task 的 label（比如 "run build"）

调试时 launch.json 的 “program” 路径为什么总报错？

program 字段不是填相对路径就完事，它受 cwd（工作目录）和 VSCode 当前打开的文件夹影响极大，尤其在多层子项目结构里。

• 最稳妥写法是用变量："program": "${workspaceFolder}/src/index.js"，而不是 "./src/index.js" —— 后者在某些终端模式下会解析失败
• 如果项目用了 ts-node 或 nodemon，别把它们塞进 program；应该用 runtimeExecutable 指定解释器，program 仍指向你的源文件
• 常见错误信息 Cannot find module 'xxx' 往往是因为 cwd 不对，导致 require() 查找路径错乱；显式加上 "cwd": "${workspaceFolder}" 能避免多数问题

实际用下来，最难调的从来不是语法或配置项，而是不同场景下变量解析顺序、终端继承环境、以及 VSCode 对当前工作区的理解偏差。这些细节不踩一遍坑，很难凭文档猜出来。