VSCode如何运行JavaScript代码_Node.js环境搭建指南-VSCode-PHP中文网

VSCode调试JavaScript需先确保系统已正确安装Node.js且PATH环境变量生效；在VSCode终端执行node -v成功是所有后续配置的前提，否则应重装Node.js并验证PATH配置。

vscode如何运行javascript代码_node.js环境搭建指南

VSCode 本身不运行 JavaScript，必须依赖系统已安装的 Node.js；如果按 F5 报 Can't find runtime executable 或终端里 node -v 失败，说明 Node.js 没装好或 VSCode 没继承环境变量——这不是配置问题，是前置条件没满足。

确认 Node.js 已安装且 VSCode 能访问到

这是所有操作的前提。VSCode 的终端和调试器都靠系统 PATH 找 node 命令，不是靠插件或设置。

在系统终端（非 VSCode）执行 node -v 和 npm -v，必须输出版本号；若报 command not found，去 nodejs.org 下载 LTS 版重装，Windows 安装时务必勾选 Add to PATH
macOS/Linux 用户：用 which node 看路径（如 /opt/homebrew/bin/node），检查该路径是否在 ~/.zshrc 的 export PATH="...:$PATH" 中；改完后必须重启 VSCode，或直接从终端运行 code . 启动
Windows 用户：打开“系统属性 → 高级 → 环境变量”，确认 C:\Program Files\nodejs\ 在“系统变量”或“用户变量”的 PATH 里；不确定就重装，勾选 Add to PATH
验证是否生效：在 VSCode 内置终端（Ctrl+`）中再跑一次 node -v；没输出就别往下配 launch.json 了

用终端手动运行是最可靠的起步方式

别急着点 F5 或写配置，先确保代码能被 node 直接执行。VSCode 终端就是你的命令行界面，它最真实反映环境状态。

新建文件夹 → VSCode 打开（File > Open Folder）→ 右键新建 index.js
写入 console.log('hello'); 并保存
在内置终端执行 node index.js，看到输出即成功
注意：import/export 默认不支持，除非项目根目录 package.json 有 "type": "module"；临时测试建议用 require()，更稳

配置 `launch.json` 实现断点调试

VSCode 调试器不是万能的，它只认 program 字段指向的真实 JS 文件路径。配错就断点不命中、报 Cannot find module 或 Cannot launch program。

Expanso yaml-to-json

使用 Expanso Edge 管道将 YAML 输入转换为 JSON 格式。

下载

按 Ctrl+Shift+D → 点“创建 launch.json” → 选 Node.js 环境
默认生成的 "program": "${file}" 适合单文件调试；若入口是 src/index.js，改成 "program": "${workspaceFolder}/src/index.js"
不要碰 runtimeExecutable，除非你明确用 nvm 切版本并需要锁定路径（如 "runtimeExecutable": "~/.nvm/versions/node/v18.17.0/bin/node"）
调试 TypeScript 或打包项目？program 必须指向编译后的 .js 文件（如 dist/index.js），不是 .ts 或 .mjs 源文件
cwd 字段影响模块解析，如果报 Cannot find module 'xxx'，大概率是工作目录设错了，显式加上 "cwd": "${workspaceFolder}"

中文乱码、日志不显示、交互式输入卡死

这些不是编码格式问题，而是 Node 输出流、VSCode 控制台子系统或插件执行策略导致的。

Windows 下中文变问号：避免用 code-runner 插件默认命令；改用内置终端手动跑，或在 launch.json 里加 "console": "integratedTerminal"
调试控制台看不到 console.log：在 launch.json 的配置中加 "env": { "NODE_OPTIONS": "--no-warnings" }，避免 warning 冲刷输出流
process.stdin 卡住：说明用了 code-runner，它不支持交互式输入；换用调试模式（F5）或终端手动执行
ESM 项目报 Cannot use import statement outside a module：确保 package.json 有 "type": "module"，且 launch.json 没误配 runtimeExecutable 覆盖了 Node 的模块解析逻辑

真正容易被忽略的是：VSCode 启动方式决定它读不读得到 shell 的 PATH，而调试器是否找到 node 和终端能否运行 node 是两回事——前者还受 launch.json 里 runtimeExecutable 干扰。很多问题表面是“VSCode 配置不对”，实际是环境没理清就往下走。