bun-development

Bun Development - 现代 JavaScript/TypeScript 快速开发指南

技能概述

Bun Development 是一个专注于 Bun runtime 的开发辅助技能，帮助您使用 Bun 进行现代化的 JavaScript 和 TypeScript 开发，涵盖包管理、打包测试、以及从 Node.js 平滑迁移的完整流程。

适用场景

启动新项目

当您需要创建全新的 JavaScript 或 TypeScript 项目时，Bun 提供了极致的开发体验——原生支持 TypeScript 和 JSX，无需配置即可直接运行，内置测试框架和打包工具，大幅提升开发速度。

从 Node.js 迁移

如果您正在考虑将现有 Node.js 项目迁移到更快的运行时，这个技能能指导您完成兼容性检查、依赖替换、脚本更新等迁移步骤，并帮助您规避常见的坑点。

优化开发工作流

当您厌倦了缓慢的包安装和繁琐的构建配置时，Bun 的 10-100 倍包安装速度、内置的 bundler 和 test runner 可以显著简化您的开发流程。

核心功能

项目初始化与配置

快速创建 Bun 项目（bun init），自动生成优化的 tsconfig.json 和 package.json 配置，支持多种项目模板（React、Next.js、Vite、Elysia 等），让您从零开始项目只需几秒钟。

包管理与依赖操作

使用 bun add、bun remove、bun update 管理依赖，体验比传统包管理器快 10-100 倍的安装速度。支持 bunx 直接执行包命令，无需全局安装即可使用开发工具。

内置开发工具集成

直接运行 TypeScript（无需编译）、使用 bun test 编写测试、通过 Bun.serve 创建 HTTP 服务器、使用 Bun.file 读写文件、内置 SQLite 支持（bun:sqlite）和密码哈希功能，一套工具完成全栈开发。

常见问题

Bun 是什么？和 Node.js 有什么区别？

Bun 是一个现代的 JavaScript/TypeScript runtime，设计目标是成为 Node.js 的高性能替代方案。主要区别包括：启动速度快约 4 倍（~25ms vs ~100ms+），包安装速度快 10-100 倍，原生支持 TypeScript 和 JSX（无需转译），内置测试框架、打包工具和 SQLite 数据库支持。Bun 与 Node.js 高度兼容，大多数 Node.js API 和 npm 包都可以直接使用。

如何从 Node.js 项目迁移到 Bun？

迁移步骤相对简单：首先安装 Bun（curl -fsSL https://bun.sh/install | bash），删除 node_modules 和 package-lock.json 后运行 bun install 重新安装依赖，更新 package.json 中的脚本（如将 node index.js 改为 bun run index.ts，将 jest 改为 bun test），安装 Bun 类型定义（bun add -d @types/bun）。大部分代码无需修改即可运行，但需要注意避免使用 Node.js 特有 API（如 require.resolve 可用 import.meta.resolve 替代）。

Bun 支持所有 Node.js 包吗？

Bun 对 Node.js 生态系统有很高的兼容性，绝大多数 npm 包可以直接使用。Bun 实现了 Node.js 的核心模块（如 fs、path、crypto、process、Buffer 等），使得现有代码无需大幅修改。不过，部分依赖 Node.js 内部实现或原生模块的包可能存在问题。建议迁移前先在开发环境测试关键功能，或者查看 Bun 兼容性列表 了解详细支持情况。