运行时包管理器打包器测试运行器代码检查格式化指南参考博客反馈

指南

使用 Bun 完成常见任务的代码示例和操作指南

概述

1

使用 Bun 完成常见任务的代码示例和操作指南

部署

6

在 Vercel 上部署 Bun 应用

在 Railway 上部署 Bun 应用

从 CLI 或仪表盘将 Bun 应用部署到 Railway，可选配置 PostgreSQL 并自动启用 SSL

在 Render 上部署 Bun 应用

在 AWS Lambda 上部署 Bun 应用

在 DigitalOcean 上部署 Bun 应用

在 Google Cloud Run 上部署 Bun 应用

运行时与调试

9

为 Bun 安装 TypeScript 声明文件

重新映射导入路径

使用 VS Code 扩展调试 Bun

使用网页调试器调试 Bun

使用 V8 堆快照检查内存使用情况

使用 --define 实现构建时常量

定义并替换静态全局变量和常量

在 GitHub Actions 中安装并运行 Bun

在 macOS 上为单文件 JavaScript 可执行文件进行代码签名

解决运行 JavaScript 可执行文件时出现的“无法打开，因为来自未识别的开发者”Gatekeeper 警告。

实用工具

19

将 Bun 升级到最新版本

检测代码何时在 Bun 中执行

获取当前 Bun 版本

编码和解码 base64 数据

使用 gzip 压缩和解压数据

使用 DEFLATE 进行数据压缩和解压

转义 HTML 字符串

检查两个对象是否深度相等

固定毫秒数的休眠

将文件 URL 转换为绝对路径

将绝对路径转换为文件 URL

获取可执行二进制文件的路径

获取当前文件的目录

获取当前文件的文件名

获取当前文件的绝对路径

检查当前文件是否为入口点

获取当前入口文件的绝对路径

生态系统与框架

27

使用 Astro 和 Bun 构建应用

创建一个 Discord 机器人

使用 Docker 容器化 Bun 应用程序

在 Bun 中使用 Drizzle ORM

在 Bun 中使用 Gel

使用 Elysia 和 Bun 构建 HTTP 服务器

使用 Express 和 Bun 构建 HTTP 服务器

使用 Hono 和 Bun 构建 HTTP 服务器

使用 Mongoose 和 Bun 读写 MongoDB 数据

使用 Drizzle ORM 连接 Neon Postgres

使用 Neon 的无服务器 Postgres 结合 Bun

使用 Next.js 和 Bun 构建应用

使用 Nuxt 和 Bun 构建应用

使用 PM2 作为守护进程运行 Bun

在 Bun 中使用 Prisma

在 Bun 中使用 Prisma Postgres

使用 Qwik 和 Bun 构建应用

使用 Bun 构建 React 应用

使用 Remix 和 Bun 构建应用

使用 Bun 启动 TanStack Start

在 Bun 应用中添加 Sentry

使用 SolidStart 和 Bun 构建应用

服务器端渲染（SSR）React 组件

使用 SvelteKit 和 Bun 构建应用

使用 systemd 将 Bun 作为守护进程运行

使用 Vite 和 Bun 构建前端

使用 Bun 连接 Upstash Redis

HTTP 与网络

13

常见的 HTTP 服务器用法

编写一个简单的 HTTP 服务器

使用 fetch 发送 HTTP 请求

热重载 HTTP 服务器

启动 HTTP 服务器集群

使用“reusePort”选项并发运行多个 HTTP 服务器，使多个进程共享同一端口

在 HTTP 服务器上配置 TLS

使用 fetch() 代理 HTTP 请求

将文件作为 HTTP 响应流式传输

使用 FormData 通过 HTTP 上传文件

在 Bun 中通过 unix 域套接字进行 fetch

使用异步迭代器的流式 HTTP 服务器

使用 Bun 的服务器发送事件（SSE）

使用 Node.js 流的流式 HTTP 服务器

WebSocket

4

构建一个简单的 WebSocket 服务器

构建一个发布-订阅 WebSocket 服务器

在 WebSocket 上设置每个 socket 的上下文数据

启用 WebSocket 消息压缩

进程与系统

13

启动子进程

从子进程读取标准输出

从子进程读取 stderr

解析命令行参数

从 stdin 读取

派生子进程并使用 IPC 通信

监听操作系统信号

以纳秒为单位获取进程运行时间

运行 Shell 命令

在 Bun 中设置时区

设置环境变量

读取环境变量

包管理器

17

添加开发依赖

添加可选依赖

添加一个 peer 依赖

添加 Git 依赖

添加一个 tarball 依赖

以不同名称安装包

使用 workspaces 配置 monorepo

覆盖 bun install 的默认 npm registry

使用 bun install 为组织作用域配置私有注册表

使用 bun install 配合 Azure Artifacts npm 注册表

使用 bun install 配合 Artifactory

添加受信任的依赖

生成兼容 yarn 的锁文件

从 npm install 迁移到 bun install

配置 git 以比较 Bun 的 lockb 锁文件

在 GitHub Actions 中使用 Bun 安装依赖

测试运行器

19

使用 Bun 测试运行器运行测试

使用 Bun 的监听模式运行测试

从 Jest 迁移到 Bun 的测试运行器

在 `bun test` 中使用模拟函数

在 `bun test` 中监视方法

在 Bun 的测试运行器中设置系统时间

在 `bun test` 中使用快照测试

在 `bun test` 中更新快照

使用 Bun 测试运行器生成代码覆盖率报告

使用 Bun 测试运行器设置代码覆盖率阈值

使用通配符模式有选择地并发运行测试

设置通配符模式以决定来自哪些文件的哪些测试并行运行

使用 Bun 测试运行器跳过测试

使用 Bun 测试运行器将测试标记为“todo”

使用 Bun 测试运行器设置单个测试超时

使用 Bun 测试运行器提前中止

使用 Bun 测试运行器多次重新运行测试

在 Bun 中使用 Testing Library

使用 Bun 和 happy-dom 编写浏览器 DOM 测试

使用 bun test 导入、require 和测试 Svelte 组件

模块系统

6

导入 JSON 文件

导入 TOML 文件

导入 YAML 文件

导入 JSON5 文件

导入 XML 文件

将 HTML 文件作为文本导入

HTML 处理

2

使用 HTMLRewriter 提取网页中的链接

提取社交分享图片和开放图谱标签

Streams

12

将 ReadableStream 转换为字符串

将 ReadableStream 转换为 JSON

将 ReadableStream 转换为 Blob

将 ReadableStream 转换为 Buffer

将 ReadableStream 转换为 ArrayBuffer

将 ReadableStream 转换为 Uint8Array

将 ReadableStream 转换为块数组

将 Node.js Readable 转换为字符串

将 Node.js Readable 转换为 JSON

将 Node.js Readable 转换为 Blob

将 Node.js Readable 转换为 Uint8Array

将 Node.js Readable 转换为 ArrayBuffer