VitePress
VitePress 是一个由 Vite 和 Vue 驱动的静态站点生成器，可以用 Markdown 快速创建精美的文档站点。
框架定位
Waku 是一个面向 React 生态的服务端组件框架，核心目标是降低服务端渲染与组件化开发的复杂度。它并不试图取代 Next.js 或 Remix 的完整功能集，而是聚焦于“轻量”与“开发体验”两个维度，为偏好精简工具链的团队提供替代方案。
核心特性
- 服务端组件优先：默认在服务端执行组件逻辑，减少客户端 JavaScript 体积，页面加载时无需等待大量脚本解析。
- 最小化配置：启动项目不需要复杂的构建配置或约定式目录结构，上手路径较短。
- React 原生能力集成：基于 React Server Components 规范构建，与 React 的演进方向保持同步。
- 细粒度数据获取：组件级别直接获取数据，避免传统“页面级 getServerSideProps”的集中式数据加载模式。
适用场景
| 场景 | 适配程度 | 说明 |
|---|---|---|
| 内容驱动型网站 | 高 | 服务端渲染天然适合 SEO 与首屏性能要求高的页面 |
| 中小型应用 | 高 | 轻量特性减少了框架层面的维护成本 |
| 复杂后台系统 | 中 | 需要自行补充路由、权限等基础设施 |
| 既有 Next.js 项目迁移 | 低 | 框架约定与 API 差异较大，迁移成本需评估 |
开发体验设计
Waku 在开发体验上的取舍比较明确：牺牲部分“全家桶”式的开箱即用能力，换取更透明的运行机制和更少的抽象层。开发者能更直接地感知组件在服务端与客户端的边界，这对于调试和性能优化是有意义的。
上手建议
- 从官方文档的“快速开始”入手，用最小示例验证服务端组件的渲染行为。
- 关注其路由方案与数据获取 API，这两部分决定了实际项目中的架构方式。
- 评估团队对 React Server Components 的熟悉程度，Waku 的学习曲线与这一规范直接相关。
- 在生产使用前，确认部署环境对 Node.js 运行时和流式渲染的支持情况。
