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 都要重新点“开始调试”，而不是复用旧会话。
