{
  "id": "bun",
  "title": "Bun",
  "lang": "zh-Hans",
  "source_lang": "en",
  "summary": "Bun 是一套 JavaScript 和 TypeScript 工具，将运行时、包管理器、打包器和测试运行器集于一个可执行文件。",
  "category": "computer-science",
  "subcategory": "software",
  "type": "product",
  "aliases": [],
  "generated_at": "2026-11-05",
  "model": "pro/gpt-6.1-sol",
  "url": "https://aiwiki.page/zh/bun/",
  "translations": {
    "en": {
      "url": "https://aiwiki.page/en/bun/",
      "json": "https://aiwiki.page/en/bun.json"
    }
  },
  "sections": [
    {
      "heading": "",
      "text": "Bun 是一套用于开发和运行 JavaScript 与 TypeScript 应用程序的开源软件工具集。它将运行时、包管理器、打包器和测试运行器集成在一个可执行文件中。Bun 的设计注重与 Node.js 及其软件包生态系统的广泛兼容，既可以作为一体化开发工具链，也可以替换现有项目中的个别工具。它的运行时使用与 WebKit 相关的 JavaScript 引擎 JavaScriptCore，而不是 Node.js 使用的 V8 引擎。"
    },
    {
      "heading": "设计与架构",
      "text": "Bun 旨在降低执行开销，同时简化 JavaScript 开发环境的搭建。安装依赖、执行脚本、转换 TypeScript、打包应用程序代码和运行测试等通常由不同程序处理的任务，都可以通过同一个命令行界面完成。\n\nBun 的大部分代码使用 Zig 编程语言实现，应用程序代码则由其 JavaScript 引擎 JavaScriptCore 执行。两者的职责有所不同：JavaScriptCore 提供语言执行和内存管理功能，包括垃圾回收；Bun 则提供文件访问、网络通信、模块加载和包管理等功能。\n\n与其他服务端 JavaScript 运行时一样，Bun 支持异步编程和事件循环。JavaScript 的 Promise 和异步输入输出机制使程序能够处理大量尚未完成的操作，而不必为每个连接分配独立的应用程序线程。这并不意味着运行时中的所有工作都在单个线程上完成，也不意味着异步代码会自动并行执行 CPU 密集型任务。\n\nBun 可在 Linux、macOS 和 Windows 上运行，具体支持的平台和处理器取决于所用版本的要求。"
    },
    {
      "heading": "运行时与语言支持",
      "text": "JavaScript 和 TypeScript 执行\n\nBun 能够执行 JavaScript，也可以直接接受 TypeScript 源文件。此外，它还支持 JSX 及其 TypeScript 对应形式 TSX；JSX 是一种常用于描述用户界面的语法扩展。\n\n直接执行 TypeScript 并不意味着会进行完整的静态类型检查。Bun 会将 TypeScript 转换为可执行的 JavaScript，移除类型注解，并处理受支持的语法。检查程序是否符合 TypeScript 的类型系统仍是一项独立任务，通常由 TypeScript 编译器或开发工具完成。\n\n例如：\n\nconst message: string = \"Hello from Bun\";\nconsole.log(message);\n\n可以使用以下命令执行：\n\nbun run hello.ts\n\n同一组命令也可以运行项目 package.json 文件中声明的脚本。\n\n模块与兼容性\n\nBun 同时支持使用 import 和 export 的 ECMAScript 模块，以及传统上使用 require 和 module.exports 的 CommonJS 模块。这两种模块系统之间的互操作性十分重要，因为 JavaScript 项目经常依赖采用不同规范编写的软件包。\n\nBun 实现了许多 Node.js 应用程序编程接口，包括文件、路径、流、缓冲区和网络相关接口。它还实现了 fetch、Request 和 Response 等 Web 标准接口，使服务端运行时与网页浏览器能够采用一些相似的编程方式。\n\n兼容 Node.js 是一项工程目标，并不代表保证两者行为完全一致。应用程序可能依赖未公开的实现细节、特定的原生扩展，或调度和错误处理方面的细微差异。因此，兼容程度取决于具体应用程序使用的接口和软件包。\n\nBun 专有接口\n\n除兼容性接口外，Bun 也提供自己的接口，包括用于处理超文本传输协议请求的 Bun.serve、通过 Bun.file 和 Bun.write 进行的文件操作，以及通过 bun:sqlite 模块对 SQLite 的访问。\n\n以下最简服务器示例展示了其请求与响应模型：\n\nBun.serve({\n  port: 3000,\n  fetch(request) {\n    return new Response(\"Hello\");\n  },\n});\n\nBun 专有接口可以提供更简洁的调用方式或性能优势，但直接使用这些接口会使程序依赖 Bun，除非其他环境也提供兼容实现。"
    },
    {
      "heading": "包管理",
      "text": "Bun 的包管理器可以安装 package.json 中描述的依赖，并从 npm 注册表获取软件包。常见命令包括：\n\nbun install\nbun add package-name\nbun remove package-name\n\n项目不必使用 Bun 作为运行时，也能使用它的包管理器。例如，可以用 Bun 安装依赖，同时继续在 Node.js 上运行应用程序。\n\n依赖解析会选出满足已声明约束的软件包版本。锁文件会记录解析得到的依赖关系图，使后续安装能够更一致地复现这些版本选择。Bun 曾使用二进制锁文件 bun.lockb，后来又引入了基于文本的新格式 bun.lock；具体行为取决于 Bun 版本和项目配置。\n\n软件包安装也涉及安全问题。依赖中可能包含在安装过程中执行代码的生命周期脚本。Bun 提供可信依赖机制，用于控制哪些依赖可以运行此类脚本。这减少了一种安装期间执行代码的途径，但并不能证明某个软件包是安全的：当应用程序导入或运行软件包时，其中的代码仍可能执行。"
    },
    {
      "heading": "打包与测试",
      "text": "打包器\n\n模块打包器会沿着项目中的导入关系查找模块，并将其合并或重新组织为适合部署的输出文件。Bun 通过 bun build 和可由程序调用的构建接口提供这项功能。\n\n它的构建系统能够转换 JavaScript、TypeScript 和 JSX，生成源码映射，并进行代码压缩和摇树优化等处理。摇树优化会移除被判定为未使用的代码，但实际结果取决于模块结构、副作用和构建配置。\n\n打包与运行时执行是不同的过程。Bun 可以生成面向浏览器或其他 JavaScript 环境的代码，但构建成功本身并不能证明目标环境中具备所有必需的接口。\n\n测试运行器\n\nbun test 命令通过内置的测试用例、断言、生命周期钩子和模拟功能来运行测试。其接口遵循 JavaScript 开发者熟悉的 Jest 风格测试惯例。\n\n这种集成可以减少配置和代码转换开销，对 TypeScript 项目尤其如此。不过，语法相似并不意味着与 Jest 的每项功能、插件或执行行为都完全兼容。依赖专门测试基础设施的项目可能需要进行调整。"
    },
    {
      "heading": "开发历史",
      "text": "Bun 由 Jarred Sumner 创建，在 2023 年 9 月发布 1.0 版本之前就已公开开发。它最初着重强调快速的 JavaScript 执行和依赖安装，随后逐步扩展为一体化工具链。\n\n核心项目以 MIT 许可证分发，随附的第三方组件则分别受各自许可证约束。源代码公开使开发者能够检查实现、报告兼容性问题并贡献修改。"
    },
    {
      "heading": "性能与实际局限",
      "text": "性能是 Bun 的核心设计目标，但“更快”并不是单一指标。启动延迟、软件包安装时间、测试执行、HTTP 吞吐量、构建速度和内存占用，衡量的是工具链的不同方面。\n\n结果取决于工作负载、硬件、操作系统、缓存状态、依赖关系图和软件版本。小型 HTTP 基准测试或许能反映运行时开销，但对于主要耗时在外部数据库查询或网络延迟上的应用程序，其参考价值可能很有限。JavaScriptCore 和 V8 在不同计算负载下的表现也可能不同。\n\nBun 的一体化设计能够简化开发，但也将多项职责集中在一个工具中。更新 Bun 可能同时改变运行时行为、依赖安装、构建和测试。另一方面，其组件也可以单独采用，让项目在重视兼容性或既有工作流程的环节保留其他工具。\n\n可移植性的主要分界在于标准化的 JavaScript 行为与特定环境提供的功能之间。语言语法可能具有可移植性，但 Node.js 内部机制、Bun 专有接口、原生扩展以及对操作系统的假设则未必如此。因此，支持某种编程语言，并不等于与应用程序的执行环境完全兼容。"
    }
  ],
  "links": [
    "javascript",
    "open-source-software",
    "garbage-collection",
    "asynchronous-programming",
    "event-loop",
    "type-system",
    "application-programming-interface",
    "web-browser",
    "hypertext-transfer-protocol",
    "mit-license",
    "operating-system"
  ],
  "sources": [],
  "license": "https://creativecommons.org/licenses/by/4.0/"
}