必须同时提供headline、datePublished（ISO 8601格式）、author（对象，@type为Person或Organization），且@context不能拼错；JSON-LD应置于末尾；description和image（绝对URL、合规尺寸）影响富摘要展示；须用Google Rich Results Test验证。
Article类型必须填哪些字段才被Google识别
只写 @type: "Article" 不会触发富媒体摘要，Google 会直接忽略。必须同时提供 headline、datePublished、author（且 author 必须是对象，不能是字符串），缺一不可。
常见错误包括：
-
datePublished写成 "2026年5月1日" 或 "2026/05/01" —— 必须是 ISO 8601 格式，如"2026-05-01T14:50:00+08:00"或至少"2026-05-01" -
author直接写"张三"—— 应该是{"@type": "Person", "name": "张三"}；如果是机构，@type得设为"Organization" - 漏掉
@context或拼错成@conext—— 验证工具会直接报错
JSON-LD应该放在HTML的哪个位置
推荐统一放在 末尾，紧挨着 。不建议塞进 或动态插入（比如用 document.write 或 React useEffect 注入），因为部分爬虫可能跳过或延迟解析。
理由很实际：
立即学习“前端免费学习笔记（深入）”；
Wechat Article Html
下载
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
-
中的<script type="application/ld+json"></script>是无执行逻辑的纯数据块，不影响页面渲染 - 放在
开头可能被某些 CMS 或 SSR 框架意外截断 - 若页面使用服务端渲染（SSR），务必确保 JSON-LD 在首屏 HTML 中已存在，而不是靠 JS 后续补上
description 和 image 字段怎么填才有效
description 不是可选装饰项——它直接影响搜索结果中的摘要文字。如果没填，Google 可能从正文前几句自动截取，但不可控；填了，就大概率直接采用。
image 字段要求更具体：
- 值必须是绝对 URL（如
"https://example.com/cover.jpg"），相对路径会被忽略 - 图片宽高比建议在 1.5:1 到 4:3 之间，最小尺寸 696×448 像素，否则可能无法展示富摘要图
- 不要指向 CDN 缓存失效页（如 404 或重定向链过长），Google 会静默丢弃整个
image字段
如何快速验证JSON-LD是否生效
别只信浏览器“查看源代码”——那只能确认代码存在，不能确认语义正确性。必须用官方工具验证：
- 用 Google 的 Rich Results Test（已整合进新 Search Console）粘贴 URL 或 HTML 片段
- 注意看错误提示里的具体字段名，比如
"datePublished is not a valid date"比笼统的“结构化数据无效”有用得多 - 如果页面有多个
<script type="application/ld+json"></script>块，工具默认只校验第一个；多类型共存时需手动检查每个块
最常被忽略的一点：JSON-LD 中的 @id 和 mainEntityOfPage 虽非强制，但一旦填写，就必须与页面真实 URL 完全一致（含协议、大小写、尾部斜杠），否则可能被判定为内容不匹配。
