页面渲染模式

渲染模式决定 Web 页面在何时、何处生成。Zion 支持 CSR、SSG 和 SSR，三种模式在页面生成方式、数据更新和 SEO 支持方面有所不同。

在设置 → SEO → 渲染模式中选择当前 Web 应用的渲染模式。SEO 的完整配置流程参阅Web 应用 SEO。

对比渲染模式

CSR

工作原理

用户访问页面时，服务端先返回基础 HTML 和前端资源。浏览器加载并执行这些资源，获取页面所需的数据，再生成页面内容。

优点与限制

• 优点：页面在访问时获取数据，后台数据变化后不需要重新发布；适合交互较多的应用页面。
• 限制：首次显示内容前需要加载并执行前端资源；不能配置页面 SEO。
• 适用场景：后台管理工具、数据看板和登录后使用的业务页面。

SSG

工作原理

发布应用时，Zion 根据页面配置和当时的数据生成静态 HTML。用户访问时直接获取已经生成的页面，不需要服务端再次生成 HTML。

优点与限制

• 优点：直接提供预生成页面，不需要在每次请求时执行服务端渲染；支持页面 SEO。
• 限制：页面保留发布时的数据；数据、页面配置或动态路径参数变化后，需要重新发布应用。
• 适用场景：官网、产品介绍、博客和其他内容相对稳定的公开页面。

动态页面

如果页面路径包含参数，例如 /article/:slug，需要在 SEO 设置中配置可能使用的路径参数值。Zion 会在发布时为这些参数值生成对应的 URL 和静态页面。

参数值可以来自指定的数据表和字段，并可通过筛选条件限制需要生成的记录。新增或修改参数值后，需要重新发布应用。

SSR

工作原理

用户请求页面时，服务端获取当前数据并生成页面 HTML，再将完整页面返回浏览器。每次页面请求都会执行这一过程。

优点与限制

• 优点：页面可以使用请求时的数据，同时支持页面 SEO。
• 限制：每次请求都需要服务端生成页面，其响应和承载能力取决于服务器；仅向购买单租户服务器的项目提供。
• 适用场景：内容更新频繁、同时需要页面 SEO 的公开页面。

选择渲染模式

• 不需要页面 SEO，且希望页面始终读取最新数据时，选择 CSR。
• 内容相对稳定，并希望直接提供预生成页面时，选择 SSG。
• 内容更新频繁，同时需要页面 SEO 时，选择 SSR。

切换渲染模式或修改 SSG 动态页面配置后，需要重新发布应用。