Bun中文文档

Bun 中文文档 Read the docs → 什么是 Bun？ Bun 是 JavaScript 和 TypeScript 应用程序的一站式工具包。它作为一个名为bun的单个可执行文件提供。

"Bun" 是用于 JavaScript 和 TypeScript 应用程序的一站式工具包。它以一个名为 bun 的单一可执行文件的形式发布。

安装 Bun 以一个单一的可执行文件进行发布，可以通过几种不同的方式进行安装。 macOS and Linux Windows Bun 为 Windows 提供了一个有限的、实验性的本机构建。

Quickstart 让我们使用内置的 Bun.serve API 编写一个简单的 HTTP 服务器。

要安装 Bun 内置 API 的 TypeScript 定义，请安装bun-types。 然后在您的tsconfig.json中的compilerOptions.types中包括"bun-types"

bun init 使用交互式的 bun init 命令来创建一个空白项目。您不需要使用 `bun create` 来使用 Bun。您根本不需要任何配置。这个命令存在是为了使入门更加快速和简便。

bun CLI 可用于执行 JavaScript/TypeScript 文件、package.json脚本和可执行包。

TypeScript Bun 原生支持 TypeScript，无需任何额外设置。所有文件在执行之前都会被 Bun 的本地快速转译器即时转译。

TypeScript Bun 将 TypeScript 视为一等公民。 运行 .ts 文件 Bun 可以直接执行 .ts 和 .tsx 文件，就像执行普通 JavaScript 一样，无需额外配置。

Bun 支持 .jsx 和 .tsx 文件。Bun 的内部转译器会在执行之前将 JSX 语法转换为普通的 JavaScript。

Bun 会自动读取您的.env文件，并提供以编程方式读取和写入环境变量的惯用方法。此外，Bun 特定的环境变量还可以配置 Bun 的运行时行为的某些方面。

Bun 实现了一组本地 API，这些 API 可以通过Bun全局对象和一些内置模块来访问。这些 API 经过了大量优化，代表了实现一些常见功能的规范的“Bun-native”方式。

Bun 在服务器优先的运行时环境中不支持一些 Web API，例如DOM API或History API等，因为它们通常与浏览器环境相关。

Bun 致力于实现完整的 Node.js API 兼容性。大多数针对Node.js环境的npm包都可以直接在 Bun 中使用；确保兼容性的最佳方法是尝试使用它。

Bun 提供了一个通用的插件 API，可以用于扩展运行时和打包器（bundler）。 插件会拦截导入并执行自定义加载逻辑：读取文件、转译代码等。

Bun 支持两种通过 CLI 标志自动重新加载的方式： --watch 模式，当导入的文件更改时，硬重启 Bun 的进程。 --hot 模式，当导入的文件更改时，对代码进行软重载（不重新启动进程）。

JavaScript 中的模块解析是一个复杂的主题。 当前，生态系统正处于从 CommonJS 模块向本机 ES 模块的多年过渡期中。

如果在工作目录或更高级目录中找不到node_modules目录，Bun 将放弃 Node.js 风格的模块解析，改用Bun 模块解析算法。

Bun 的行为可以使用其配置文件bunfig.toml进行配置。 一般来说，Bun 依赖于预先存在的配置文件，如package.json和tsconfig.json来配置其行为。

Bun 支持WebKit Inspector Protocol，因此您可以使用交互式调试器来调试您的代码。为了演示，考虑以下简单的 Web 服务器示例。