框架对比与选择
对比维度：性能、版本化、多语言、插件生态、易用性、团队技术栈、部署平台。
快速选择建议
- 需要版本化/多语言、React 团队：Docusaurus。
- Vue 团队、轻量/极快写作体验：VitePress。
- 性能与 SEO 优先，需混合框架/少量交互：Astro。
- 后端/数据团队，喜欢 Python 工具链：MkDocs(+Material)。
核心对比表
| 维度 | VitePress | Docusaurus | Astro | MkDocs(Material) |
|---|---|---|---|---|
| 技术栈 | Vue 3 + Vite | React | 多框架（内容优先） | Python + Jinja |
| 版本化 | 插件/自定义 | 内置 | 自定义/插件 | 插件 |
| 多语言 | 路由/插件 | 内置 i18n | 路由/插件 | 插件 |
| 博客 | 可配置 | 内置 | 自定义/组件 | 插件 |
| 搜索 | 本地/Algolia 插件 | 内置 Algolia 配置方便 | 本地/自建 | 内置插件 |
| 扩展 | 主题钩子/自定义组件 | 插件/主题丰富 | 集成生态/MDX 组件 | 插件、主题 |
| 性能 | 快 | 快 | 极快（静态+按需 JS） | 快 |
| 部署 | 静态任意托管 | 静态任意托管 | 静态/SSR/边缘 | 静态任意托管 |
选型 Checklist
- 是否需要 版本化？是否需要 多语言？
- 团队主力前端框架？（Vue / React / 混合）
- 是否需要嵌入复杂 Demo（可用 Astro 岛屿或 Docusaurus MDX）？
- 部署平台（静态托管/CDN/边缘），是否需要 SSR/ISG/增量生成？
- 插件与主题生态要求（搜索、Algolia、博客、统计、图表）。***