Bun Docs关于本站
Bun Docs 的社区身份、资料来源、编辑原则、更新策略与纠错方式
最后更新于
社区身份
Bun Docs 是社区维护的 Bun 实用知识库，不隶属于 Bun、Oven 或其商业合作方。导航中的“Bun 官方”链接会明确跳转到 bun.com。
本站不复制官方 API 参考，而是围绕入门、迁移、云部署、AI 应用和编码 Agent 提供任务型说明。涉及精确接口、版本支持或安全行为时，以正文链接的一手官方资料为准。
编辑原则
- 先查接口：命令、配置键和平台能力必须经过当前官方文档核对。
- 区分事实与建议：可验证行为写明来源；经验性建议写清适用边界。
- 不伪造兼容性：本地成功不代表框架、云平台或原生依赖已经获得生产验证。
- 双语同构：中文与英文保持相同 slug 和主题范围，但根据各自阅读习惯撰写。
- 安全优先：依赖脚本、密钥、工具调用、生产写入和 Agent 权限必须说明风险。
- 可复现：示例给出前置条件、预期结果和验证步骤，不使用无法执行的占位接口。
来源层级
| 优先级 | 来源 | 用途 |
|---|---|---|
| 1 | Bun 官方文档与 API Reference | 运行时、包管理、测试、打包与部署事实 |
| 2 | 云平台、框架与 SDK 官方文档 | 平台边界、版本状态和集成方法 |
| 3 | 标准与安全机构的一手规范 | HTTP、容器、搜索和安全要求 |
| 4 | 社区材料 | 仅用于发现问题，不作为关键事实的唯一依据 |
更新与纠错
页面底部会显示该页的最后核验日期。单独复核过的页面显示自己的 lastVerified 日期；其余页面显示全站复核日期，当前为 2026-08-02。发生以下变化时应重新复核相关页面：
- Bun 稳定版本改变默认行为；
- 云平台改变 Bun runtime 的支持状态；
- SDK、框架或部署适配器升级；
- 安全公告影响示例依赖或推荐配置；
- 读者提供了可复现的错误证据。
配置 NEXT_PUBLIC_REPO_URL 指向公开源码仓库后，每个文档页底部会显示 GitHub 编辑链接；未配置时链接保持隐藏，避免误导归属。发现问题时，请向站点维护者提供页面 URL、Bun 版本、最小复现和官方依据。
搜索与机器读取
HTML 页面是搜索引擎的规范版本。.md、llms.txt 与 llms-full.txt 服务于 Agent 和离线索引，会通过 X-Robots-Tag 避免成为重复搜索结果，但仍允许直接读取。