Node.js 断点调试
给出跑不通或行为异常的 Node/TypeScript 代码与复现场景 → 用 node inspect 或 Chrome 调试协议下断点、查作用域变量、取堆快照与 CPU 火焰图。
功能与用途
当常规日志输出无法定位复杂状态时,本能力通过 Node 内置 V8 inspector 与 Chrome 开发者工具协议(CDP)在终端执行断点调试。支持在指定代码行或函数入口暂停、单步跟踪调用栈、导出局部与闭包作用域变量,并在当前栈帧中动态求值。覆盖命令行快速交互、自动化 CDP 脚本批量断点、附加到运行中服务或终端 UI 进程,以及抓取性能快照与排查深层运行时异常。
适用场景
- 单测失败与闭包状态探查:在测试报错断点处单步跟进,直接读取外层闭包与局部变量的即时值,排查日志难以捕获的数据篡改或逻辑异常。
- 生产服务或常驻进程在线附加:向已运行的常驻 Node 进程发送信号开启调试端口,使用命令行挂载并检查卡死、异常请求时的即时调用栈与状态。
- React 与 Ink 终端 UI 渲染调试:在终端 UI 组件渲染或输入事件触发处下断点,捕获预渲染组件 props 与 state,修复界面崩溃与异常交互。
- CDP 脚本自动化批量收集状态:编写无头脚本通过 Chrome 调试协议自动触发断点并导出上下文属性,实现无需人工交互的深层缺陷自动复现。
适用人群
- Node.js 后端开发工程师
- 前端/CLI 工具开发工程师
- 终端 UI 与 TypeScript 应用开发者
使用步骤
- 说明出问题的脚本或场景、期望的调试目标,以及是挂到新进程还是已运行进程
- 优先用 node inspect 启动并停在首行,在 debug> 提示符下用 sb 下断点、c 继续、n/s/o 单步、bt 看调用栈
- 需要在当前作用域查变量时进 repl 子模式,直接敲表达式读取局部与闭包变量
- 要附加到运行中进程就先 kill -SIGUSR1 开启 inspector,再用 node inspect -p 或 ws:// 地址挂接
- 需要自动化或性能分析时改用 chrome-remote-interface 脚本,批量设置断点、采集 CPU profile 或堆快照
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-10
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Debug Node.js via --inspect + Chrome DevTools Protocol CLI.
使用前准备
- 需要 Node.js 运行环境与命令行
- 使用 CDP 脚本化路径需 npm 安装 chrome-remote-interface,TypeScript 需 tsx 等转译工具
依赖与权限
- NODE_PATH
- 读取用户主动提供的内容