AI Skill 大全

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 应用开发者

使用步骤

  1. 说明出问题的脚本或场景、期望的调试目标,以及是挂到新进程还是已运行进程
  2. 优先用 node inspect 启动并停在首行,在 debug> 提示符下用 sb 下断点、c 继续、n/s/o 单步、bt 看调用栈
  3. 需要在当前作用域查变量时进 repl 子模式,直接敲表达式读取局部与闭包变量
  4. 要附加到运行中进程就先 kill -SIGUSR1 开启 inspector,再用 node inspect -p 或 ws:// 地址挂接
  5. 需要自动化或性能分析时改用 chrome-remote-interface 脚本,批量设置断点、采集 CPU profile 或堆快照

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
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
  • 读取用户主动提供的内容

同类 Skill