VSCode 内置 JavaScript 调试器开箱即用，无需额外“可视化调试工具”插件；关键在于正确配置 Node.js 环境、launch.json（含 ${workspaceFolder} 路径、"request": "launch"、"console": "integratedTerminal"）及断点路径匹配。
VSCode 本身不依赖额外“可视化调试工具”插件——它的内置 JavaScript 调试器（node 类型调试器）就是官方原生、图形化、开箱即用的调试界面。所谓“安装可视化调试工具”，本质是配对好 Node.js 运行时 + 正确配置 launch.json，而非装某个叫“可视化调试”的扩展。
确认 node 命令在 VSCode 终端中可用
这是所有调试的前提，90% 的“断点不命中”“F5 没反应”问题都卡在这步。
- 在系统终端（CMD/PowerShell/Terminal）中运行
node -v和npm -v，必须输出版本号 - 在 VSCode 内置终端（
Ctrl + `）中执行同样命令——结果必须一致；若不一致，说明 VSCode 没读取你的 shell 配置（如~/.zshrc），需重启 VSCode 或手动设置terminal.integrated.env.linux/.osx/.windows - M1/M2 Mac 用户常见报错
zsh: command not found: node，大概率是 Homebrew 安装后未链接：运行brew link node
创建正确的 launch.json（关键字段不能错）
launch.json 是调试行为的唯一定义文件，写错路径或模式，VSCode 就无法启动调试进程。
- 必须使用
${workspaceFolder}表达式拼接入口路径，例如："program": "${workspaceFolder}/src/index.js" - 禁用 POSIX 相对路径：
"./src/index.js"或"src/index.js"都会失败 - 确保
"request": "launch"（本地启动）而非"attach"（连接已有进程），除非你明确要 attach 到node --inspect启动的服务 - 推荐加上
"console": "integratedTerminal"，让输出直接落在 VSCode 终端里，避免弹新窗口
断点失效或灰掉？检查这三处
断点显示为空心圆（灰色）= 调试器没加载到对应源码，不是代码问题，而是路径或构建环节出错。
- 当前打开的文件夹是否为项目根目录？
${workspaceFolder}指向的就是它，不是某层子文件夹 - 入口文件（如
index.js）是否真在指定路径？路径区分大小写，Windows 除外但建议统一小写 - 如果是 TypeScript 项目，
"program"不能指向.ts文件——必须用ts-node作为运行时："runtimeExecutable": "npx", "runtimeArgs": ["ts-node", "--inspect-brk", "${workspaceFolder}/src/index.ts"]
想热重载调试？别装插件，用 nodemon 集成
VSCode 不支持原生热重载，但可无缝集成 nodemon 实现保存即重启 + 断点保留。
- 本地安装：
npm install --save-dev nodemon - 修改
launch.json中的配置："type": "node",<br>"runtimeExecutable": "${workspaceFolder}/node_modules/.bin/nodemon",<br>"runtimeArgs": ["--inspect-brk", "${workspaceFolder}/src/index.js"] - 注意：
--inspect-brk会让进程在第一行暂停，确保断点来得及注入；去掉-brk则只监听变化，不中断
真正容易被忽略的是：VSCode 调试器不会自动识别 package.json 中的 main 字段或 npm start 脚本——它只认 launch.json 里写的 program。哪怕你 npm start 能跑通，调试仍可能失败。路径、模式、运行时三者必须严格匹配，少一个环节，那个红色断点就只是个装饰品。
