node环境配置成功的唯一标准是vscode终端能直接运行node -v和npm -v并显示版本号；否则需检查path是否包含node安装目录及npm全局bin路径，并重启vscode。
能直接在 VSCode 终端里敲 node -v 和 npm -v 并看到版本号，才是 Node 环境配成功的唯一标准；其他所有“看起来能跑”的现象，都可能在调试或全局命令时突然失效。
node -v 报 command not found 的真实原因
不是 VSCode 有问题，而是它没继承你系统里已生效的环境变量。Windows 上最常见的是安装 Node.js 时没勾选 Add to PATH；即使勾了，某些旧版安装器仍会漏掉用户级 PATH 条目。
- 打开命令提示符（非 VSCode 内置终端），执行
node -v和npm -v—— 如果这里都失败，说明 Node 根本没装好，重装并确保勾选 Add to PATH - 如果命令提示符里成功，但 VSCode 终端里失败：关掉所有 VSCode 窗口，重新用“文件 → 打开文件夹”方式启动项目，不要双击文件打开
- 仍不行？检查系统环境变量里的
Path是否包含 Node.js 安装目录（如C:\Program Files\nodejs\）；若没有，手动添加并重启 VSCode
launch.json 中 program 字段写成 "${file}" 才能通用
VSCode 调试时默认生成的 launch.json 里 "program": "${workspaceFolder}/index.js" 是硬编码路径，换一个文件调试就报错。
- 把
program改成"${file}"，这样 F5 调试当前打开的 JS 文件，无需每次改配置 - 注意：
${file}不会自动保存未保存的文件，调试前务必按Ctrl+S - 如果项目有固定入口（比如
server.js），可设为"${workspaceFolder}/server.js"，但别写绝对路径
npm 全局工具在 VSCode 里找不到 command not found
比如装了 nodemon，系统终端能用，VSCode 终端却提示 command not found，本质是 npm 全局 bin 目录没进 PATH。
- 先查全局路径：
npm config get prefix，输出类似D:\npm-global - 把这个路径下的
node_modules\.bin（Windows）或bin（macOS/Linux）加进系统 PATH - 例如 Windows 下加的是
D:\npm-global\node_modules\.bin，不是D:\npm-global - 改完 PATH 后，必须完全退出 VSCode（包括后台进程），再重新打开项目
国内 npm install 卡住或超时
官方 registry 域名解析慢、连接不稳定，不是网络问题，是源本身不可靠。
- 换镜像：运行
npm config set registry https://registry.npmmirror.com（淘宝镜像已停用，这是当前有效地址） - 验证是否生效：
npm config get registry应输出上面那串 URL - 不建议装
cnpm—— 它和 npm 不完全兼容，尤其在依赖解析和 lockfile 处理上容易出错 - 如果仍卡在某个包，试试加
--no-audit --no-fund减少额外请求
最容易被忽略的点是：VSCode 终端是否真正读取了 shell 配置（如 ~/.zshrc）。Windows 用户基本不用操心这点，但如果你用 WSL 或 Git Bash 作为 VSCode 默认终端，就得确认 source ~/.zshrc 是否在 shell 启动时执行——否则 npm 配置、别名、PATH 修改全都不生效。
