如何在VSCode中运行和调试JavaScript代码？_Node.js环境配置详解【教程】

vscode需依赖node.js运行javaScript，必须先安装node.js并配置PATH，确保终端中node -v和npm -v可执行；再通过VSCode内置终端运行node index.js验证；调试需正确配置launch.json中的program和cwd路径。

VSCode 本身不直接运行 javascript，必须依赖外部运行时（最常见的是 Node.js）。没有装 Node.js 或没配好 PATH，点“运行”只会报错 Command 'node' not found。

确认 Node.js 已正确安装并可被 VSCode 调用

这是所有后续操作的前提。VSCode 的终端和调试器都靠系统 PATH 找 node 命令。

• 在系统终端（非 VSCode）执行 node -v 和 npm -v，确保有输出版本号
• 如果报错，重装 Node.js（推荐使用 https://nodejs.org/ 官方 LTS 版），安装时勾选 “Add to PATH”
• 重启 VSCode —— 很多人改完 PATH 不重启，VSCode 仍读不到新环境
• 在 VSCode 内置终端（Ctrl+`）里再试 node -v，必须成功

用终端手动运行 JS 文件是最简单可靠的起步方式

别急着配 launch.json，先验证代码能跑通。VSCode 终端就是你的命令行界面。

• 打开含 index.js 的文件夹（用 File > Open Folder）
• 按 Ctrl+` 呼出终端，输入 node index.js
• 如果有 console.log，应该立刻看到输出；若报错，错误信息会直接显示在终端里
• 注意：Node 默认不支持 es6 import/export（除非加 "type": "module" 到 package.json），用 require() 最稳

配置 launch.json 实现断点调试需匹配实际入口和运行模式

VSCode 调试器不是万能的，它依赖 launch.json 中的 program、runtimeExecutable 等字段精准指向目标文件和运行时。

立即学习“Java免费学习笔记（深入）”；

• 按 Ctrl+Shift+D 打开调试面板 → 点“创建 launch.json” → 选“Node.js”环境
• 生成的默认配置里，"program": "${file}" 表示调试当前打开的文件，适合单文件脚本
• 如果入口是 src/index.js，请显式改成 "program": "${workspaceFolder}/src/index.js"
• 调试 typescript 或带构建步骤的项目？别直接调试 .ts，先确保已编译，或改用 runtimeArgs 指向 ts-node
• 遇到 Cannot find module？检查 cwd（工作目录）是否设对，Node 的模块解析路径由此决定

{   "version": "0.2.0",   "configurations": [     {       "type": "node",       "request": "launch",       "name": "Launch index.js",       "program": "${workspaceFolder}/index.js",       "console": "integratedTerminal",       "skipFiles": ["/**"]     }   ] }

断点调试真正卡住的地方，往往不是语法，而是路径拼错、工作目录不对、或用了不兼容的模块语法。每次改完 launch.json 都要重新点“开始调试”，而不是复用旧会话。