知识库 / 阶段 3 · 技术 SEO 与开发协作 / 搜索引擎优化（SEO） ↗ / 第 036 节

SEO字段调用统一规范

SEO字段调用统一规范（V1.0）#

适用范围：导航站 / 影视站 / 资讯站 / 内容站 / CMS系统
 适用角色：后端开发 / 前端开发 / SEO / 产品 / 测试

一、制定目的#

统一 SEO 相关字段的 命名规则、来源、调用方式、输出位置与优先级，确保：

  • SEO字段 不写死、不临时拼、不依赖人工改模板

  • 前后端 字段含义一致

  • 模板可复用、可扩展

  • SEO配置可规模化落地

二、SEO字段统一设计原则（必须遵守）#

  1. 单一来源原则
    每一个 SEO 字段只能有一个权威来源，不允许多处生成。

  2. 后端控制原则
    SEO字段由后端统一生成与管理，前端只负责渲染。

  3. 模板优先原则
    所有页面必须支持 SEO 模板兜底逻辑。

  4. 不可硬编码原则
    前端模板、静态文件中禁止写死 SEO 文本。

  5. 字段可扩展原则
    所有 SEO 字段预留扩展能力，避免二次重构。

三、基础SEO字段调用规范（全站通用）#

SEO字段 统一字段名 数据来源 前端调用位置 是否必填
页面标题 seo_title 后端SEO模块 <title> ✅
页面描述 seo_description 后端SEO模块 <meta name="description"> ✅
页面关键词 seo_keywords 后端SEO模块 <meta name="keywords"> ⭕
Canonical canonical_url 后端路由逻辑 <link rel="canonical"> ✅
Robots meta_robots 后端SEO模块 <meta name="robots"> ⭕
页面URL page_url 后端路由 Schema/日志 ✅

四、SEO字段优先级规则（非常重要）#

SEO字段调用顺序必须遵循以下优先级：

手动配置字段

→ 页面级SEO模板

→ 分类级SEO模板

→ 站点级SEO默认模板

示例（Title生成逻辑）：#

if (page.seo_title exists)

use page.seo_title

else if (category.seo_title_tpl exists)

use category.seo_title_tpl

else

use site.default_seo_title

五、H标签字段调用规范（结构核心）#

SEO结构 字段名 前端标签 是否必填 说明
页面主标题 page_title <h1> ✅ 每页唯一
模块标题 module_title <h2> ✅ 可隐藏
子模块标题 section_title <h3> ⭕ 内容分段

⚠️ 规范说明：

  • H标签 必须存在于HTML源码

  • UI不适合展示时，使用 CSS 隐藏

  • 禁止使用 <div> 代替 H 标签

六、内容页（文章/资讯）SEO字段调用#

SEO项 字段名 来源 说明
文章标题 title 内容表 同时用于 H1
SEO标题 seo_title SEO配置 可与title不同
SEO描述 seo_description SEO配置 自动截取可兜底
作者 author_name 内容表 用于Schema
发布时间 publish_date 内容表 必填
更新时间 update_date 内容表 可选
分类 category_name 分类表 用于Breadcrumb
标签 tags[] 标签表 内链用

七、影视站（VideoObject）字段调用规范#

SEO字段 字段名 是否必填 用途
视频标题 video_title ✅ H1 / Title
视频描述 video_description ✅ Schema
缩略图 thumbnail_url ✅ Rich Result
视频URL video_url ⭕ Schema
嵌入URL embed_url ⭕ Schema
时长 duration ⭕ ISO8601
分类 video_category ✅ Breadcrumb
演员 actors[] ⭕ 内链

八、结构化数据字段统一调用（JSON-LD）#

所有 Schema 必须：

  • 由后端完整生成

  • 前端 原样输出

  • 禁止拆分或手写

统一字段：#

Schema类型 字段名
Article schema_article
NewsArticle schema_news
VideoObject schema_video
BreadcrumbList schema_breadcrumb
WebSite schema_website
FAQPage schema_faq

前端模板统一：

<script type="application/ld+json">
{{schema_xxx}}
</script>

九、分页与列表页字段调用规范#

SEO项 字段名 前端输出
当前页码 current_page 逻辑
总页数 total_pages 逻辑
上一页URL prev_url <link rel="prev">
下一页URL next_url <link rel="next">
分页URL模板 page_url_tpl 路由

十、内链模块字段统一规范#

内链类型 字段名 用途
相关文章 related_posts[] 内容集群
推荐内容 recommended[] 权重流
专题入口 topic_url 核心权重
分类入口 category_url 结构
标签入口 tag_url 长尾

十一、IndexNow字段调用规范（后端）#

功能 字段/接口 说明
推送URL url_list[] 新/更/删
推送类型 push_type new/update/delete
推送状态 push_status 日志
推送时间 push_time 监控
Key indexnow_key 固定

十二、前端调用统一规范（必须遵守）#

  • 前端 禁止拼 SEO 文本

  • 前端 禁止写死 SEO 文案

  • 前端 禁止覆盖后端SEO字段

  • 所有SEO字段必须来自接口变量

十三、测试与验收统一标准#

上线前必须验证：

  • ☐ Title正确输出

  • ☐ Description非空

  • ☐ H1唯一

  • ☐ Canonical正确

  • ☐ Schema正常解析

  • ☐ 分页prev/next存在

  • ☐ 内链模块有数据

  • ☐ IndexNow推送成功

结语#

SEO字段统一规范，是实现“SEO自动化、模板化、规模化”的根基。

没有字段统一 → SEO只能靠人
字段统一 → SEO才能靠系统