Bun Docs:Bun 官方文档,从安装入门到运行时、包管理与测试工具的查阅
首页的分区与入口
首页的“Get Started”部分把新读者引向三处:安装页(说明支持的平台和各种安装方式)、快速开始页(用 Bun.serve 写一个 hello world),以及 Bun 功能概览。文档顶部导航按工具划分为 Runtime、Package Manager、Bundler、Compiler、Test Runner、Linter、Formatter 等页签,另有 Guides、Reference 和 Blog。左侧目录则按主题细分,例如 Core Runtime 下有 Watch Mode、Debugging、REPL 和 bunfig.toml,Networking 下有 Fetch、WebSockets、TCP 和 UDP。
首页的一句话介绍分别对应不同工具。运行时执行 JavaScript 与 TypeScript 文件和 package 脚本,页面称开销接近零;包管理器支持工作区、overrides 和审计;测试运行器兼容 Jest 的写法并支持快照;打包器支持代码分割和插件。首页还列出了类型检查(bun check)、代码检查(bun lint,页面称内置约 1000 条规则)和格式化(bun fmt)三个命令。

截图顶部导航中没有 Compiler 页签,截至 2026 年 10 月的官网导航已加入该页签,其余目录与首页内容一致。
以 bun install 为例:命令页怎样组织
包管理器分区的页面结构比较固定:先给出命令示例,再逐条说明。以 bun install 为例,基本用法包括安装项目的全部依赖(直接运行 bun install)、安装指定版本(如 react@19.1.1)以及安装指定标签(如 react@latest)。页面说明,bun 可以直接用在已有的 Node.js 项目中,只要项目里有 package.json。页面还称,把 npm install 换成 bun install,安装速度最多可快 25 倍,这是官网的说法。

截图中的命令示例与截至 2026 年 10 月的页面一致,截图中的顶部导航同样没有 Compiler 页签。
生命周期脚本默认不执行
这一页有一段值得注意的安全说明。Bun 默认不执行已安装依赖的 postinstall 等生命周期脚本,页面称这是出于安全考虑。若某个依赖确实需要运行这类脚本,需要把它的名字加入 package.json 的 trustedDependencies 字段,然后重新安装。页面明确指出,这一点与其他 npm 客户端的做法不同,迁移旧项目时需要提前留意。