node.js需独立安装并正确配置path，vscode终端需继承shell环境变量；launch.json中program应设为"${file}"或固定入口文件；npm需配置国内镜像和自定义全局路径并重装工具。
Node.js 必须独立安装，VSCode 本身不提供运行时；装完后 node -v 和 npm -v 在任意终端都能执行成功，才是有效配置的起点。
验证 node 和 npm 是否真可用
很多人以为双击安装包点“下一步”就完事了，结果在 VSCode 终端里敲 node -v 报错 command not found。根本原因通常是安装时没勾选 Add to PATH，或系统环境变量没刷新。
- Windows 用户：重装 Node.js 时务必勾选 “Add Node.js to PATH”，否则手动把 Node.js 安装目录（如
C:Program Files odejs）加进系统Path变量 - macOS/Linux 用户：若用
homebrew安装，确认which node输出路径已加入 shell 配置（~/.zshrc或~/.bash_profile） - VSCode 内置终端可能缓存旧环境：关掉所有 VSCode 窗口，重新打开项目文件夹再试
launch.json 中 program 字段别写死
VSCode 调试时自动生成的 launch.json 默认是 "program": "${workspaceFolder}/app.js"，这会导致你换一个文件（比如 server.js）调试时 F5 直接失败。
- 改成
"program": "${file}"，调试当前打开的 JS 文件，无需反复改配置 - 如果项目有入口文件（如
index.js），可设为"program": "${workspaceFolder}/index.js"，但需确保该文件始终存在 - 注意：
${file}不会自动保存未保存的文件，调试前务必按Ctrl+S（Windows/Linux）或Cmd+S（macOS）
npm 镜像和全局路径建议提前配好
国内直接用官方 registry 经常卡在 npm install，且全局模块（如 nodemon）默认装在系统盘，容易占满 C 盘空间。
- 换淘宝镜像（当前有效地址）：
npm config set registry https://registry.npmmirror.com - 改全局安装路径（例如放 D 盘）：
npm config set prefix "D:\npm-global"，再把该路径加进系统PATH - 验证是否生效：
npm config get prefix和npm config get registry应输出对应值 - 改完后重装全局工具：
npm install -g nodemon，之后就能在任意目录用nodemon app.js
最容易被忽略的是：VSCode 的终端是否继承了你 shell 里已生效的 npm 配置。如果在系统终端能用 nodemon，但在 VSCode 里提示 command not found，大概率是终端没读取 shell 配置文件，这时重启 VSCode 或手动在终端里执行 source ~/.zshrc 更直接。
