知识库 / 附录 · 参考 / 模板 / 案例 / FAQ / 搜索引擎优化（SEO） ↗ / 第 097 节

SEO 模板字段映射表（前后端必备）

适用对象：前端开发 / 后端开发 / SEO 专员 / 产品经理
 适用范围：页面模板级（首页 / 列表页 / 详情页 / 专题页）

一、基础 SEO 字段映射（所有页面通用）#

SEO项 后端字段（示例） 前端输出位置 是否必填 SEO说明
Title seo_title <title> ✅ 每页唯一，核心关键词
Description seo_description <meta name="description"> ✅ 搜索摘要
Keywords seo_keywords <meta name="keywords"> ⭕ 可选
Canonical canonical_url <link rel="canonical"> ✅ 防重复
Robots meta_robots <meta name="robots"> ⭕ 控制索引
页面URL page_url 所有SEO字段引用 ✅ 绝对路径

二、H 标签结构字段映射（页面结构核心）#

SEO结构 后端字段 前端标签 是否必填 说明
H1 page_title <h1> ✅ 页面主主题
H2 模块标题 module_title <h2> ✅ 可隐藏
H3 子标题 section_title <h3> ⭕ 内容分段
分类名称 category_name <h1> 或 <h2> ✅ 列表页主标题

⚠️ 说明：

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

  • UI 不适合展示时，可 CSS 隐藏，但不可删除

三、内容页（文章 / 博客）字段映射#

SEO项 后端字段 前端位置 是否必填 说明
文章标题 title H1 / Title ✅ 与页面主题一致
正文内容 content_html <main> ✅ 必须直出
作者 author_name 文本 / Schema ⭕ 提升可信度
发布时间 publish_date 文本 / Schema ✅ 收录重要信号
更新时间 update_date Schema ⭕ 内容新鲜度
分类 category 内链 / 面包屑 ✅ 结构定位
标签 tags[] <a> 链接 ⭕ 主题关联
封面图 cover_image <img> ⭕ ALT 必填

四、影视站（VideoObject）字段映射（重点）#

SEO项 后端字段 前端 / Schema 是否必填 说明
视频标题 video_title H1 / Title ✅ 页面核心
视频描述 video_description 正文 / Schema ✅ 决定理解度
缩略图 thumbnail_url Schema ✅ 富摘要
播放URL video_url Schema ⭕ 直链
嵌入URL embed_url Schema ⭕ iframe
时长 duration Schema ⭕ ISO 8601
分类 video_category 面包屑 ✅ 层级
演员 actors[] <a> / Schema ⭕ 内链资源

五、结构化数据（JSON-LD）字段映射#

Schema类型 后端字段集合 前端输出位置 是否必填
Article schema_article <script type="application/ld+json"> ✅
NewsArticle schema_news 同上 ⭕
VideoObject schema_video 同上 影视站必填
BreadcrumbList schema_breadcrumb 同上 ✅
WebSite schema_website 同上 首页
FAQPage schema_faq 同上 ⭕

⚠️ 前端必须：

  • 原样输出 JSON

  • 不转义

  • 不拆分

六、分页与列表页字段映射#

SEO项 后端字段 前端输出 是否必填 说明
当前页码 current_page 文本/逻辑 ✅
总页数 total_pages 逻辑 ✅
Prev URL prev_url <link rel="prev"> ⭕
Next URL next_url <link rel="next"> ⭕
列表数据 list_items[] <a> 列表 ✅
分页URL规则 page_url_tpl 路由 ✅ /page/{n}/

七、内链模块字段映射（开发必须支持）#

内链类型 后端字段 前端表现 SEO作用
相关文章 related_posts[] <a> 列表 主题集群
推荐内容 recommended[] <a> 列表 权重流
专题入口 topic_url <a> 核心权重
分类入口 category_url <a> 结构强化
标签入口 tag_url <a> 长尾

八、IndexNow 推送字段映射（后端）#

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

九、前后端对接统一规范（强制）#

  1. 字段命名统一（避免同义字段混乱）

  2. SEO字段不可写死在前端

  3. 模板中必须预留 SEO 注入点

  4. JSON-LD 完整由后端生成

  5. URL 规则由后端控制，前端只渲染

十、上线前 SEO 模板验收清单（基于字段）#

  • ☐ Title 正确输出

  • ☐ Description 非空

  • ☐ H1 唯一

  • ☐ Canonical 正确

  • ☐ Schema 正确渲染

  • ☐ 分页 prev/next 正确

  • ☐ 内链模块有数据

  • ☐ IndexNow 推送成功

结语（非常重要）#

SEO 模板字段映射，是前后端协作的“共同语言”。

没有映射表 → SEO只能靠人工补救
有映射表 → SEO可以规模化、模板化、自动化