能跑 node -v 且 VSCode 能断点调试才算真正搭好环境；node -v 报错主因是系统未识别 Node.js，Windows 须重装并勾选 Add to PATH，macOS/Linux 需确保 shell 配置加载 nvm.sh，且必须用终端启动 code . 并重启 VSCode 验证。
能跑 node -v 且 VSCode 能断点调试，才算真正搭好——其余全是可选项。
node -v 报错：'node' 不是内部或外部命令
这不是 VSCode 的问题，是系统根本没认出 Node.js。Windows 安装时漏勾 “Add to PATH” 是主因；macOS/Linux 用 nvm 却没在 shell 配置里写 source ~/.nvm/nvm.sh 也会导致同样现象。
- 先关掉所有终端（包括已打开的 VSCode），重新下载 LTS 版 .msi 包，安装时**必须勾选 Add to PATH**
- Windows 用户别装在含中文或空格的路径（如
D:\我的软件\nodejs），npm会静默失败 - macOS/Linux 用户执行
echo $PATH看输出里有没有nvm目录；没有就补上source ~/.nvm/nvm.sh到~/.zshrc或~/.bash_profile，然后新开终端 - 验证必须用系统终端（CMD/PowerShell/Terminal），不是 VSCode 内置终端——后者可能没继承新 PATH
VSCode 调试器提示 “Cannot find runtime 'node'”
说明 node 命令虽能运行，但 VSCode 的调试进程没拿到它。常见于 Windows 下 VSCode 没继承系统 PATH，或 macOS/Linux 下用 code 命令从桌面启动而非终端启动。
- Windows：重装 Node.js 并确保勾选 Add to PATH 后，**必须重启 VSCode（不是只重启终端）**
- macOS/Linux：不要双击图标启动 VSCode，改用终端执行
code .打开项目文件夹——这样它才能加载 shell 的完整环境变量 - 检查 VSCode 内置终端里是否能运行
node -v；不能，就说明 PATH 没生效，得回上一步排查
launch.json 里 “program” 字段总配错
VSCode 自动生成的 launch.json 默认指向 "${workspaceFolder}/index.js"，但你的入口文件可能叫 app.js、server.js 或在子目录里，不改就会报错“找不到文件”。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 务必通过 文件 → 打开文件夹 加载整个项目根目录（含
package.json或主 JS 文件），别只打开单个文件 - 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P）输入Debug: Open Configuration，选Node.js → Current File生成配置 - 手动编辑
launch.json中的"program"值，例如改成"${workspaceFolder}/app.js"或"${workspaceFolder}/src/server.js" - 别动
"type": "node"和"request": "launch"，这两个是调试器识别协议的关键字段
想调试 npm start 或 nodemon，却卡在 launch.json
直接把 "program" 改成 "npm" 并加 "args": ["start"] 可以跑，但看不到控制台输出；而用 nodemon --inspect-brk 时硬塞进 launch.json 会失败——VSCode 调试器不支持热替换进程。
- 调试
npm start：在launch.json中设"program": "npm"、"args": ["start"]、"console": "integratedTerminal" - 调试
nodemon：**必须用 attach 模式**——先在终端手动执行nodemon --inspect-brk index.js，再在launch.json里配"type": "node"、"request": "attach"、"port": 9229（默认端口） - 注意：attach 模式下断点要设在代码第一行，因为
--inspect-brk会让进程启动即暂停
真正容易被忽略的，是 VSCode 启动方式和 PATH 继承的关系——哪怕 node -v 在系统终端里成功了，双击图标启动的 VSCode 依然可能读不到它。这点在 macOS/Linux 上尤其隐蔽。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
