📥 安装问题

Q: 安装后提示 "command not found"？

A: 重新加载 shell 配置：

bash
source ~/.bashrc  # 或 ~/.zshrc
# 或重新打开终端

Q: Linux 上提示 "illegal instruction"？

A: Bun 需要 AVX2 指令集支持。检查 CPU：

bash
# 检查是否支持 AVX2
cat /proc/cpuinfo | grep avx2

🔄 兼容性问题

Q: 某些 npm 包在 Bun 中无法工作？

A: Bun 对 Node.js API 兼容性约 90%。尝试：

  • 检查是否使用了原生模块（native addon）
  • 查看 GitHub Issues
  • 使用 bunfig.toml 配置兼容模式

Q: tsconfig.json 配置不生效？

A: Bun 使用自己的 TypeScript 解析器，部分 tsconfig 选项可能不支持。确保：

  • paths 需要重启 Bun
  • baseUrl 配置正确
  • 复杂配置考虑使用 --config 参数

📦 包管理问题

Q: bun install 比 npm 慢？

A: 可能原因：

  • 首次安装需要下载到全局缓存
  • 网络问题，尝试使用镜像
  • postinstall 脚本执行时间

Q: 如何使用国内镜像？

A: 创建 .npmrc：

ini
registry=https://registry.npmmirror.com

⚡ 性能问题

Q: Bun 运行比 Node.js 慢？

A: 检查以下几点：

  • CPU 密集型任务差异不大
  • I/O 和启动速度 Bun 更快
  • 确保使用最新版本的 Bun
  • 使用 bun --bun 强制使用 Bun 运行时

🔗 相关资源