vscode默认不带node.js且不自动继承系统path，必须先确保node和npm被系统识别；windows需重装node.js并勾选“add topath”，macos/linux需通过终端启动code .并配置~/.zshrc，所有修改后须在vscode终端验证node -v和npm -v。
VSCode 装完默认不带 Node.js，也不自动继承系统 PATH —— 你得先让系统认得 node 和 npm，VSCode 才能跑起来。否则所有报错（command not found: node、调试器连不上、code-runner 假死）都源于这一步没走稳。
Node.js 安装时必须勾选 “Add to PATH”
这是 Windows 上最常被跳过的致命步骤。哪怕你装的是最新版 Node.js，只要安装向导里没勾这个选项，node -v 在 CMD 能用，VSCode 内置终端却大概率报错。
- 重装 Node.js，安装过程中在“Custom Setup”页务必勾选 Add to PATH（不是默认勾选，要手动点）
- 装完立刻打开全新 CMD 窗口，运行
node -v和npm -v—— 有输出才继续 - 别信“我之前装过”，很多旧版本 Node.js 没加 PATH 或路径被覆盖，重装是最省时间的验证方式
VSCode 启动方式决定它能不能看到环境变量
VSCode 不读你的 ~/.zshrc 或系统环境变量面板里的设置，它只继承启动它的那个 shell 的 PATH。双击图标启动，往往继承的是“干净”的 Windows session，PATH 里没有 node。
- Windows：关掉所有 VSCode 窗口，用管理员权限打开 CMD 或 PowerShell，执行
code --no-sandbox（或直接code）启动 - macOS/Linux：终端里先运行
which node，确认路径（如/opt/homebrew/bin/node），再确保该路径已写进~/.zshrc的export PATH="...:$PATH"；改完后彻底退出 VSCode，再从终端执行code . - 验证：VSCode 内置终端（
Ctrl + `）里直接敲node -v—— 没输出就别配launch.json，全是白忙
全局 npm 模块路径需要单独配置
npm install -g 默认往 C 盘写，不仅慢还可能因权限失败。必须手动改 prefix 和 cache，再把新路径加进系统 PATH，否则 express 这类全局命令在 VSCode 里照样找不到。
- 新建两个文件夹，比如
D:\nodejs\node_global和D:\nodejs\node_cache - 以管理员身份运行 CMD，执行：
npm config set prefix "D:\nodejs\node_global"npm config set cache "D:\nodejs\node_cache" - 进系统环境变量 → 编辑 “Path” → 新增一条：
D:\nodejs\node_global（注意：不是node_modules子目录，就是node_global本身） - 重启 VSCode，再在内置终端运行
npm install express -g，成功后express --version应该有响应
真正卡住人的从来不是配置项多，而是 PATH 没生效、VSCode 启动方式不对、全局模块路径没加进环境变量这三处。每改一处，都要在 VSCode 终端里亲手验证 node -v 和 npm -v，别跳步。
