这个起步模板已经配置为静态输出,因此部署流程很简单。构建步骤会为落地页以及整棵文档树生成预渲染 HTML。

本地生产构建

使用标准的 Vite+ 命令:

vp run build

这条命令会先构建工作区包,再通过 Void 解析所有路由,并因为 void.config.ts 已经启用静态模式而输出静态文件。

为什么静态输出适合这个起步模板

第一版并不依赖这些东西:

  • 数据库读取
  • 鉴权状态
  • API 路由
  • 运行时个性化内容

这意味着相比动态渲染,这个站点更能从简单性中获益。

部署检查清单

在发布之前,先确认几个基础点:

  1. 站内链接可以在文档页面之间顺畅跳转。
  2. 重要路由都带有标题和描述元数据。
  3. 生成结果中已经包含 /docs/* 下所有计划中的页面。

以后再加什么

如果站点之后需要搜索、受保护页面或动态示例,你完全可以在后面扩展架构。先从静态开始,可以给内容模型足够时间沉淀,再去增加运维复杂度。