VSCode不直接执行JavaScript,需依赖Node.js或浏览器环境;调试必须配置launch.json,否则无法运行。Node.js须已安装并加入PATH,Code Runner适合快速运行脚本,Debugger for Chrome/Edge用于前端调试,Node.js调试器需正确设置program和cwd路径。

VSCode 本身不直接执行 JavaScript,必须依赖 Node.js 运行时或浏览器环境;调试需正确配置 launch.json,否则点“运行”毫无反应。
确认 Node.js 已安装并可用
VSCode 不自带 JS 执行能力,node 命令必须能在终端中调用成功:
- 在 VSCode 内置终端(
Ctrl+`)输入node -v,应输出版本号(如v20.11.0) - 若提示
command not found: node,说明 Node.js 未安装或未加入系统 PATH - Windows 用户装完 Node.js 后建议重启 VSCode,否则 PATH 可能未刷新
用 Code Runner 快速运行单个 JS 文件
适合写小脚本、验证逻辑,无需配置文件:
- 安装扩展 Code Runner(作者:Jun Han)
- 右键编辑器中的
.js文件 → 选择Run Code,或按Ctrl+Alt+N - 输出默认显示在
OUTPUT面板的Code Runner标签页,不是终端 —— 若代码含prompt()或需要交互,它不支持 - 如需在终端中运行(例如要输入
readline),可在设置中搜索code-runner.runInTerminal,设为true
用 Debugger for Chrome / Edge 调试浏览器端 JS
适用于 HTML 中内联或引入的脚本,断点、变量监视、调用栈都可用:
立即学习“Java免费学习笔记(深入)”;
- 安装官方扩展
Debugger for Chrome或Debugger for Edge - 确保目标浏览器已启动且允许远程调试(Edge 默认开启;Chrome 需手动加启动参数或使用扩展)
- 项目根目录下建
.vscode/launch.json,内容类似:
{
"version": "0.2.0",
"configurations": [
{
"type": "pwa-chrome",
"request": "launch",
"name": "Launch index.html",
"file": "${workspaceFolder}/index.html"
}
]
}
然后按 F5 启动 —— 浏览器会新开窗口并加载页面,VSCode 自动关联调试会话。
用 Node.js 调试器调试服务端或 CLI 脚本
这是最常被配错的一环,关键在于入口路径和工作目录:
- 必须有
.vscode/launch.json,不能只靠右键“调试” -
program字段必须是绝对路径或相对于cwd的有效路径,例如:"program": "${workspaceFolder}/src/app.js" - 若脚本依赖
process.cwd()读取文件,务必设好cwd,否则fs.readFile('./config.json')会失败 - 启动后终端显示
Debugger attached才算真正进入调试模式;如果卡在Starting target...,大概率是路径错或 Node.js 版本太旧(低于 v14 不支持某些调试协议)
真正容易卡住的地方,往往不是“怎么点运行”,而是 launch.json 里 program 指向了不存在的文件,或者 cwd 和你预期的不一样 —— 建议第一次调试前,在代码开头加一行 console.log(__dirname, process.cwd()); 确认上下文。










