mcpField
B
bun-debug

bun-debug

github.com/laurigates开发5954 次安装1 天前更新
代码仓库

关于 bun-debug

bun-debug 是用于交互式调试 Bun 脚本和测试的技能，可通过 Inspector 参数启动程序并说明调试器连接方式。

主要功能

  1. 01启动 Bun Inspector
  2. 02在首行暂停
  3. 03等待调试器连接
  4. 04调试 Bun 测试
  5. 05指定 Inspector 端口

适用场景

  1. 01逐步调试 Bun 脚本
  2. 02检查快速退出的脚本
  3. 03调试匹配指定模式的 Bun 测试

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/laurigates/claude-plugins --skill bun-debug

安装后在 Claude Code 中输入/bun-debug确认已加载。

详细介绍

/bun:debug

启用 Bun 调试器，以便交互式调试脚本。

适用场景

在以下情况下使用此技能……以下情况下改用 typescript-debugging……
通过 --inspect 为 Bun 脚本附加交互式调试器诊断 TypeScript 编译错误或类型不匹配
在快速退出的脚本的第一行中断（--inspect-brk）为非 Bun 运行时设置 VSCode 启动配置
使用 bun --inspect-brk test 调试 Bun 测试如果只想运行测试而不逐步调试，请使用 bun-test
在执行前等待调试器附加如果要复现构建时错误，请使用 bun-build

参数

  • file（必需）：要调试的脚本文件
  • --brk：在第一行中断（适用于快速退出的脚本）
  • --wait：在运行前等待调试器附加
  • --port=<port>：使用指定端口（默认：自动分配）

执行

标准调试（打开调试 URL）：

bun --inspect $FILE

在第一行中断：

bun --inspect-brk $FILE

等待调试器附加：

bun --inspect-wait $FILE

自定义端口：

bun --inspect=$PORT $FILE

调试测试：

bun --inspect-brk test $PATTERN

输出

该命令会输出一个调试 URL：

------------------- Bun Inspector -------------------
Listening: ws://localhost:6499/
Open: debug.bun.sh/#localhost:6499
-----------------------------------------------------

启动后

  1. 向用户报告调试 URL
  2. 说明如何连接：
    • 在浏览器中打开 debug.bun.sh/#localhost:<port>
    • 或使用附加到 WebSocket URL 的 Bun 扩展，在 VSCode 中调试
  3. 提醒用户断点控制键（F8 继续，F10 单步跳过，F11 单步进入）

VSCode 集成

对于 VSCode 调试，建议添加以下内容到 .vscode/launch.json：

{
  "type": "bun",
  "request": "launch",
  "name": "Debug",
  "program": "${file}",
  "stopOnEntry": true
}

评论

支持 Markdown