VSCode安装并运行Node.js环境全流程配置教程

做前端或 Node 开发时，VSCode 几乎是必备工具，但有一个常见问题容易被新手忽略：编辑器本身不附带 Node.js。需要先手动安装系统级的 Node.js，并确保在任意终端中执行 node 命令都能成功。如果这一步没有完成，后续的运行、调试、npm install 等操作都无法正常进行。

VSCode 本身不包含 Node.js，必须先安装好系统级 Node.js，并确保终端中能直接执行 node 命令；否则所有后续操作（运行、调试、npm install）都会失败。

node -v 报 “not recognized” 怎么办

这个问题与 VSCode 无关，主要原因在于系统环境变量没有将 Node.js 的安装目录添加到 PATH。以下是几种常见情况及其解决方法：

• 在 Windows 上安装时未勾选“Add to PATH”——重新安装 Node.js LTS 版本时必须勾选该选项，不要省略。
• 安装路径包含中文或空格（例如 C:\我的软件\nodejs）——卸载后重新安装到纯英文路径，例如 C:\nodejs。
• VSCode 的打开时间早于环境变量更新——彻底退出 VSCode（在任务管理器中确认 Code.exe 进程已结束），然后重新打开。
• macOS/Linux 用户使用了 nvm 但未激活版本——在终端中执行 nvm use --lts，然后用 which node 验证。

验证方法很简单：关闭所有终端窗口，重新打开一个系统终端（CMD、PowerShell 或 Terminal），依次运行 node -v 和 npm -v。只有这一步成功，VSCode 中的终端才能正常使用。

VSCode 内置终端能跑 node，但调试按钮（）报错

调试器启动失败，通常是由于 launch.json 配置错误，或者项目未以文件夹形式打开。关键检查点如下：

• 必须通过「文件 → 打开文件夹」打开整个项目目录（其中应有 app.js 或 index.js），仅打开单个 JS 文件无法正常工作。
• 按 Ctrl+Shift+P 搜索 Debug: Open Configuration，选择 Node.js → Current File，生成的 launch.json 中 "program" 字段应设置为 "${file}"（动态指向当前文件），不要手动写成 "./index.js" 等固定值。
• 如果手动修改过 launch.json，请检查 "type": "node" 和 "request": "launch" 是否被删除或拼写错误。
• 调试前先保存文件（Ctrl+S），VSCode 不会自动保存未变动的文件。

npm install 后 require('express') 报错 Cannot find module

先不要急于怀疑 Express 没有安装成功，问题多半出在终端工作目录不正确，或者 node_modules 放在了错误位置：

• 确保 VSCode 内置终端的当前路径是项目根目录（即包含 package.json 的文件夹），而不是某个子文件夹。
• 先运行 npm init -y 生成 package.json，再执行 npm install express。
• 检查是否误用了全局安装（npm install -g express）——Express 必须本地安装，全局安装无效。
• 如果使用了 import 语法但未在 package.json 中添加 "type": "module"，会报 require is not defined。有两种解决方案：要么改用 const express = require('express')，要么在 package.json 中加入 "type": "module"。

Code Runner 插件右键“Run Code”失败

该插件默认不调用系统的 node 环境，而是使用自身的独立沙箱，对 require、模块路径、process.argv 的支持非常有限：

• 新手阶段建议少用此插件——直接在终端中手动输入 node app.js，路径、错误信息、权限问题一目了然。
• 如果必须使用，请在 VSCode 设置中搜索 Code-runner: Executor Map，找到 javascript 对应的值，改为 "node $fullFileName"。
• 该插件无法触发断点、不读取 launch.json，也不加载 node_modules 路径——调试请使用 F5，验证运行请使用终端。

最后补充一个容易被忽略的细节：VSCode 的内置终端是否真正继承了 shell 的全部环境变量？例如 npm 镜像、自定义的 prefix。即使 npm -v 可以正常执行，nodemon 仍可能找不到。这种情况不是重新安装就能解决的，需要检查 npm config get prefix 输出的路径是否已添加到系统 PATH 中，然后重启 VSCode。