工具对比
为什么我们选择 VitePress 而不是其他文档工具工具？
| 工具 | 优势 | 取舍 |
|---|---|---|
| Notion | 适合非技术团队快速协作，上手零门槛。 | 本地 IDE/AI 编辑能力弱，版本管理和目录化能力有限。 |
| Fumadocs | 适合追求严格结构化和强类型约束的项目。 | 规则较多，配置和出错定位成本较高。比如必须写 Front Matter 才能正常渲染。各种报错不太清晰，对小白用户不太友好。而且适配中文需要做一些配置 |
| Astro | 适合追求极致强定制能力和多框架混合的站点。 | 概念和配置相对较多，学习曲线稍陡。 |
| Nextra | 适合已经深度绑定 Next.js 生态的项目。 | 与 Next.js 的路由和版本节奏强耦合。 |
| VuePress | 适合偏 Vue 生态、重度依赖插件的项目。 | 体量较重，配置成本和启动速度不如 VitePress。 |
| VitePress | 极速热更新，Markdown 负担低，IDE/AI 友好。 | 适合文档驱动、追求开发效率和现代体验的项目。 |
为什么选择本模板？
本模板在 VitePress 的基础上，进一步优化了以下体验：
- 🚀 极速响应：基于 Vite 的秒级热更新。
- 📝 Markdown 友好：无强制 Front Matter，支持自动侧边栏。
- 🧠 IDE/AI 友好：专为 Cursor / Trae / Claude Code 等 AI 编辑器优化，流程顺滑。
- 🇨🇳 中文默认体验：导航、搜索和 UI 文案已全部中文化。