（3152期）Bun – Bun 生产避坑完全指南

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