2026 年，你应该迁移离开 Docusaurus 吗？决策指南
本页面回答一个问题：你已经在运行 Docusaurus，还应该继续使用它吗？这是一份决策指南，而不是产品目录。如果你还没有确定方向，请先阅读2026 年 Docusaurus 替代方案：9 个平台对比——该页面对整个领域进行了排名。如果你已经决定迁移到 Docsbook，请直接跳转到从 Docusaurus 迁移到 Docsbook。
简短回答：只要团队中有人负责前端构建并因此获得报酬，Docusaurus 就仍然是正确的选择。一旦没有人负责，它就不再是正确的选择。
什么时候应该继续使用 Docusaurus？#
符合以下任一情况时，请继续使用 Docusaurus。每种情况都意味着所有权成本已经付出，因此迁移不会带来任何收益。
- 您的 Docusaurus 部署目前运行正常，且尚未到下一次大版本迁移的时间。
- 您在文档页面中嵌入 React 组件——交互式演示、自定义插件、实时 playground。
- 有人的职位描述至少部分包括维护文档网站。
- 您完全不希望与供应商建立关系，并接受将托管和 CI 作为自己的成本。
React 生态系统、MDX 和 swizzle 主题化确实是优势。本页面并未声称 Docusaurus 是一个糟糕的工具；它只是指出 Docusaurus 是一个需要有人负责的工具，并询问您是否有这样的人。
什么时候应该迁移离开 Docusaurus？#
当网站没有负责人，而工作仍在不断到来时，就该迁移了。具体信号包括：
- 你的文档已经存放在
README.md和docs/文件夹中，而且没人希望为它们再设一个存放位置。 - 你希望基于内容使用 AI 聊天，又不想构建和维护检索流水线。
- 你需要让文档支持多种语言，按区域设置分别建立索引，而且没有可继承的翻译流水线。
- Node 小版本一变，文档网站就会出问题，而没有任何人的工作安排能腾出时间处理这些问题。
- 你希望通过 MCP 从 Claude Code 或 Cursor 管理文档，而不是通过配置文件管理。
运行一个 Docusaurus 技术栈实际需要多少成本？#
坦率地说，账单金额不大，但投入的工时却不少。“Docusaurus 是免费的”描述的是许可证，而不是部署成本。以下是需要根据你自己的数据进行估算的费用项目——我们特意不在这里公布任何金额，因为费用取决于你的主机、流量和薪资水平。
| 费用项目 | 由谁承担 | 表现形式 |
|---|---|---|
| 托管和 CDN | 你的主机账单 | 金额不大、可预测，但很容易被忽略 |
| 搜索 | Algolia DocSearch 审核队列，或由工程师自行托管搜索 | 免费但需要审核，或免费但需要自行运维 |
| 大版本迁移 | 工程时间 | 主题、MDX 版本和插件 API 在 Docusaurus 1 → 2 → 3 的升级过程中都曾发生不兼容变更 |
| 自定义主题维护 | 工程时间 | 一个只有某个人了解的 swizzle 目录 |
| AI 聊天（如果添加） | 第三方订阅费用加集成时间 | 不属于 Docusaurus 的一部分 |
| 翻译（如果添加） | 工程时间加翻译服务费用 | 不属于 Docusaurus 的一部分 |
在做决定之前，先估算出这张表中属于你自己的版本。真正重要的比较并不是“免费与订阅服务之间的比较”，而是“未计费的工时与需要付费的服务之间的比较”。
相比之下，Docsbook 的费用是多少？#
Docsbook 采用按需付费，而不是分级定价。每个项目都有自己的余额，该余额仅用于 AI 使用——发布网站、托管网站、提供自定义域名以及读者打开的每个页面都不会消耗余额。最新价格可在 docsbook.io/pricing 查看，该页面会在每次请求时根据实时定价常量生成。博客文章中复制的价格不会主动提示任何人其已过时，因此本页面不列出具体价格。
迁移后你会放弃什么？#
三件事，这也是继续留在上面的三个理由。
- 文档页面中的自定义 React 组件。 你仍然可以在其他地方托管演示并链接到它，但演示不会内嵌在页面中。
- Swizzle 级别的主题覆盖。 你可以使用颜色令牌、字体、布局切换，以及自定义页眉和页脚——但不能任意替换组件。
- 插件系统。 搜索、AI、翻译和分析功能都是内置的，而不是可插拔的，这就是需要做出的权衡：需要配置的内容更少，可更改的内容也更少。
迁移后您能获得什么？#
- 网站直接从您已有的 GitHub 仓库发布，无需构建步骤，也无需 CI 流水线。
- 从第一天起即可基于您自己的内容进行 AI 对话，无需运行检索流水线。
- 翻译成 15 种语言，并按语言区域分别建立索引。
- 提供 MCP 服务器，让 Claude Code 和 Cursor 直接读取和编辑文档配置。
llms.txt和llms-full.txt会自动为网站和每个工作区生成。- 分析功能可报告页面浏览量、读者向助手提出的问题，以及没有返回结果的搜索。
源文件始终不会离开您的仓库，因此迁移是可逆的：您需要迁回的内容已经在 Git 中。
迁移实际会如何进行？#
- 你的
docs/文件夹是源文件夹。将 Docsbook 指向github.com/yourorg/yourrepo。 - 网站会显示在
docsbook.io/yourorg/yourrepo。 - 连接你的自定义域名
docs.yourcompany.com，并将旧的 Docusaurus URL 逐路径重定向。 - 将 Docusaurus 仓库保留为备用，直到流量确认两者一致，然后将其删除。
第 3 步决定了迁移是否会让你的搜索流量受损。从 Docusaurus 迁移到 Docsbook中包含完整的重定向检查清单。
后续步骤#
- 2026 年 Docusaurus 替代方案：9 个平台对比 — 完整的候选平台范围，适用于 Docsbook 并非唯一选择的情况
- 从 Docusaurus 迁移到 Docsbook — 包含重定向的分步迁移指南
- 文档即代码与托管平台 — 将同一决策以原则而非账单的形式进行表述