核心用法
Bun 技能是面向生产环境的 Bun 运行时深度避坑指南，专注于解决从 Node.js 迁移、打包配置到包管理的全链路陷阱。它不是入门教程，而是针对已掌握基础的用户，提供运行时兼容性差异、打包器隐藏行为、包管理器差异等高级问题的实战解决方案。
显著优点
1. 系统性风险覆盖：涵盖 Node.js API 差异（process.nextTick、__dirname 缺失）、打包器静默行为（--target=browser 剥离 Node API）、包管理器冲突（bun.lockb 二进制不可 diff、peer deps 自动安装）等深层问题
2. 生产级细节：提供具体代码级修复方案，如 queueMicrotask 替代、import.meta.dir 迁移、--external:package 服务器依赖处理
3. 迁移场景聚焦：针对从 Node/npm 迁移的典型痛点，如 bun install 解析差异导致的"在我机器能跑"、workspaces link: 协议行为差异等
潜在局限与风险
1. 非入门资源：假设用户已熟悉 Bun 基础，无安装、Hello World 等引导内容
2. Node 生态绑定：大量篇幅处理与 Node/npm 的差异，纯 Bun 新项目参考价值降低
3. 时效性风险：Bun 版本迭代快（当前 1.0.0），部分行为细节可能随版本变化
4. 安全扫描缺失：报告明确标注"未执行安全扫描"，技能来源可信度需依赖官方 Bun 文档交叉验证
适合人群
- Node.js 迁移团队：需评估迁移成本、识别兼容性雷区
- 生产环境维护者：排查 Bun 运行时异常、打包产物问题
- CI/CD 工程师：处理
bun.lockb合并冲突、多包管理器混用场景
常规风险
- 类型安全幻觉：Bun 直接运行 TS 不经过
tsc，类型错误可能流入生产 - 测试迁移成本：Jest 到
bun test的断言 API、mock 时序、快照格式差异需重写测试 - 热重载状态污染：
--hot保留状态可能导致调试困难