SEO（搜索引擎优化）

SEO（Search Engine Optimization，搜索引擎优化）是指通过优化网站结构和内容，提高关键词在搜索引擎中的排名，吸引更多用户访问网站，获得更多流量。

SEO 是一项持续且系统性的工作。Zion 平台为开发者提供了丰富且易用的 SEO 配置工具，包括：

• 渲染模式（CSR/SSR/SSG）
• 网站地图（Sitemap）
• robots.txt 配置
• 自定义 Header/Body 标签
• H 标签（标题结构）
• 图片 Alt 文本
• Canonical URL
• Open Graph 协议

使用 SEO 功能前，建议具备基础 SEO 知识。可参考 百度SEO指南  或 Google SEO Starter Guide 。

配置教程

打开“设置”进入“SEO”模块。所有 SEO 配置需在项目发布后才会生效。

全局配置

全局配置会影响项目下所有页面。

选择渲染模式

渲染模式决定页面生成的时机和方式，直接影响性能和 SEO 效果。Zion 支持三种模式：

• 客户端渲染（CSR）：页面在浏览器端渲染，首屏加载慢，SEO 效果差。除了 robots.txt 和 sitemap 能够被爬虫访问外，其他内容都无法被百度正常抓取和收录。
• 服务端渲染（SSR）：页面在服务器端渲染，首屏加载快，SEO 效果较好。
• 发布时生成（SSG）：项目发布时预生成所有页面，首屏极快，SEO 效果最佳。

可在页面 head 标签中查看渲染方式：

配置路径参数的范围

为什么要配置路径参数范围？

当页面设置了路径参数后，页面的 URL 会动态生成，此时可以将其理解为带有变量的模板 URL。

以 Zion 官网的博客页为例，其 URL 形式为 functorz.com/blog/${slug}，其中 ${slug} 就是路径参数（变量）。需要为该参数提供所有可能的取值，系统据此完成以下操作：

• 生成所有页面的 URL，并将这些 URL 添加到 sitemap.xml 中。
• 在 SSG 模式下，系统会为每个 URL 预先构建对应的 HTML 页面。

如何设置参数范围？

支持以下两种方式提供参数值，系统会自动合并去重，生成最终的页面清单：

• 静态数据：手动输入固定的文本值，适用于内容固定的页面。
• 数据库：从指定的数据表中动态获取参数值。可设置筛选条件，精准控制需要生成的页面。

配置示例

仍以官网的博客文章页为例，可以为其配置数据库来源：

• 数据表：blog
• 字段：slug
• 筛选条件：published == true

假设 blog 表中有如下 5 条数据：

最终将生成以下 3 个 URL 及对应页面：

设置网站地图（Sitemap）

网站地图用于告知搜索引擎网站页面结构，提升爬取效率。

• 实时生成：用户访问页面后，URL 自动收录进 sitemap。
  • 优点：动态性强
  • 缺点：未访问页面可能不被收录
• 预生成：发布时根据路径参数范围生成 sitemap。
  • 优点：所有页面均被收录（前提是参数设置正确）
  • 缺点：数据变更需重新发布

设置 robots.txt

robots.txt 用于指定搜索引擎爬虫的抓取权限，相当于网站“守门人”。

自定义 Header / Body

可在 HTML Header/Body 中添加 meta、canonical 等标签，辅助 SEO 或代码注入（如百度/谷歌统计）。

页面级配置

页面级配置仅对单个页面生效。

SEO TDK

可为页面设置标题（Title）、描述（Description）、关键词（Keywords），帮助搜索引擎理解网页内容。

社交媒体展示（Open Graph）

设置网页在 Facebook、X（Twitter）等社交媒体上的展示内容。Zion 支持 Open Graph 协议，提升社交曝光。

Canonical URL

为避免权重分散，可在页面 head 中添加 canonical 标签，指明主页面：

<link rel="canonical" href="https://www.functorz.com" />

H 标签（标题结构）

H 标签用于标识页面内容层级，利于搜索引擎索引。

图片 Alt 属性

Alt 属性帮助搜索引擎理解图片内容，提升图片搜索排名。

发布项目让配置生效

所有 SEO 配置需在项目发布后生效。

功能边界

SEO 能力与渲染模式强相关，不同版本支持的渲染模式如下：

CSR 模式下，页面的 TDK、社交媒体等 SEO 配置均无法生效。