Bun中文文档

bun CLI 包含一个与 Node.js 兼容的包管理器，旨在极大地提高包的安装速度，可作为npm、yarn和pnpm的显著更快的替代品。它是一个独立的工具，适用于现有的 Node.js 项目；

所有从注册表下载的包都存储在全局缓存中，位于 ~/.bun/install/cache。它们存储在子目录中，名称类似于 ${name}@${version}，因此可以缓存多个版本的包。

Bun 支持package.json中的workspaces。工作区使得开发复杂软件变得容易，这些软件作为一个由多个独立包组成的monorepo。

运行 bun install 会创建一个名为 bun.lockb 的二进制锁定文件。 为什么是二进制的？ 简而言之：性能。Bun 的锁定文件保存和加载非常快速，并保存了比通常在锁定文件中包含的数据要多

默认注册表是 registry.npmjs.org。可以在 bunfig.toml 中进行全局配置： 要配置私有注册表并将其限定到特定组织： .npmrc Bun 目前不读取 .npmrc 文件。

bun pm 命令组提供了一组工具，用于与 Bun 的包管理器一起使用。要打印本地项目的 `bin` 目录路径

Bun 的快速本地打包器现在处于测试阶段。可以通过bun build命令行命令或Bun.build()JavaScript API 来使用它。

Bun 打包工具实现了一组默认的加载器，可以直接使用。通常情况下，Bun 打包工具和运行时都默认支持相同的文件类型。

Bun 提供了通用的插件 API，可用于扩展运行时和打包工具。 插件可以拦截导入并执行自定义加载逻辑，例如读取文件、转译代码等。它们可以用于添加对其他文件类型的支持，比如.scss或.yaml。

Bun 的打包工具实现了--compile标志，用于从 TypeScript 或 JavaScript 文件生成独立的二进制文件。

宏是一种在 Bun 中的机制，允许你在捆绑（bundle）时运行 JavaScript 函数，这些函数的返回值直接内联到你的捆绑文件中。

Bun 的捆绑器 API 受esbuild的强烈启发。从 esbuild 迁移到 Bun 的捆绑器应该相对无痛。本指南将简要解释为什么您可能考虑迁移到 Bun 的捆绑器

Bun 附带了一个快速的、内置的、与 Jest 兼容的测试运行器。测试使用 Bun 运行时执行,Bun 旨在与 Jest 兼容，但并非所有功能都已实现。

您可以使用内置的bun:test模块导入与 Jest 类似的 API 来定义测试。长期来看，Bun 旨在实现完全的 Jest 兼容性；目前，支持的expect匹配器集合有限。

要在文件更改时自动重新运行测试，可以使用--watch标志： Bun 会监视测试文件中导入的任何文件的更改，并在检测到更改时重新运行测试。 这个功能非常快速

Bun 的测试运行器支持以下生命周期钩子。这对于加载测试数据、模拟数据和配置测试环境非常有用。 钩子 描述 beforeAll 在所有测试之前运行一次。 beforeEach 在每个测试之前运行。

你可以使用 mock 函数来创建模拟函数。或者，你也可以使用 jest.fn() 函数，就像在 Jest 中一样。它的行为是相同的。

快照测试是使用 .toMatchSnapshot() 匹配器编写的： 第一次运行这个测试时，expect 的参数将被序列化并写入与测试文件相邻的 __snapshots__ 目录中的特殊快照文件中。

bun:test 允许您在测试中更改时间。 这适用于以下任何内容： Date.now new Date() new Intl.DateTimeFormat().format() 定时器目前尚未受到影响

Bun 的测试运行器与现有的组件和 DOM 测试库（包括 React Testing Library 和Happy DOM）很好地协作。