最稳妥方式是用嵌入json-ld,需严格遵循格式规范:双引号、合法json、正确@type、置于head或body内,article类型须含headline、datepublished、author,日期用iso 8601,图片url须绝对且可访问,本地用google url inspection tool验证,优先选用google明确支持的schema类型。

怎么给HTML加Schema标记(JSON-LD最稳妥)
直接用 <script type="application/ld+json"></script> 嵌入JSON-LD,是目前兼容性最好、Google最推荐的方式。Microdata和RDFa语法更绕,且容易因HTML结构变动失效。
常见错误现象:Google Search Console 报“无法解析结构化数据”,多半是 JSON 格式不合法(比如末尾多逗号、单引号代替双引号)、type 拼错(如写成 "Person" 却漏了 @type 字段),或脚本没放在 或 里(不能在 <script></script> 外层再套其他标签)。
- 必须用双引号包裹所有键和字符串值,JSON 不认单引号
-
@context一般固定为"https://schema.org",别手抖写成http或拼错 - 如果页面有多个实体(比如文章+作者+网站),就用数组包多个对象,别强行合并成一个大对象
Article 类型怎么填才被 Google 当作正规文章
不是随便加个 Article 就能触发富摘要。Google 明确要求:必须包含 headline、datePublished、author(且 author 至少带 @type 和 name),缺一不可。
使用场景:博客正文页、新闻详情页。首页或列表页填 WebPage 或 CollectionPage 更合适,硬塞 Article 反而被忽略。
-
datePublished必须是 ISO 8601 格式,如"2024-05-20T09:30:00+08:00",只写"2024-05-20"也行,但别用中文日期或斜杠分隔 -
author推荐用嵌套对象,而不是只写字符串;如果作者是机构,@type得设为"Organization",不是"Person" - 图片字段填
image时,URL 必须可公开访问、返回 200 状态码,相对路径要转成绝对路径
本地部署测试 Schema 是否生效
别等上线再查——用 Google Rich Results Test(现整合进 URL Inspection Tool)本地验证。把 HTML 文件拖进去,或粘贴完整 HTML 源码(含 <script type="application/ld+json"></script> 块),它会实时报错定位。
性能影响几乎为零:JSON-LD 是纯声明式数据,不执行、不阻塞渲染,也不触发网络请求。但注意别在每个页面都重复注入同一份网站级数据(比如 logo、主域名),该用 WebSite 的地方才放,避免冗余。
- 测试时务必关掉浏览器插件(尤其广告屏蔽、隐私类),它们可能过滤掉
script标签 - 如果用了 SSR 框架(如 Next.js),确保 JSON-LD 在服务端吐出,而不是仅靠
useEffect客户端注入——Googlebot 不执行 JS - 检查控制台有没有
SyntaxError: Unexpected token,那基本是 JSON 里混进了 HTML 注释或未转义的换行符
哪些 Schema 类型现在实际有效(别白忙)
Google 官方文档明确支持的类型才值得投入:目前稳定支持 Article、FAQPage、HowTo、Product、Review、LocalBusiness。像 CreativeWork 这种泛型,或自定义 @type,基本不会触发富结果。
容易踩的坑:看到别人用 Event 出了日历卡片,就给自己活动页也加——但 Google 要求 Event 必须带 startDate、location(且 location 是完整对象),还要页面本身有清晰的活动时间与地点正文,否则只是“识别到”而非“展示富摘要”。
-
FAQPage和HowTo对内容结构强依赖:问题必须用<h3></h3>或语义化标题包裹,步骤得是有序列表,否则解析失败 - 电商类优先填
Product+Offer+AggregateRating,别只堆Thing这种顶层类型 - 所有日期时间字段统一用 UTC 或带时区偏移,别混用本地时间字符串
Schema 不是开关,是描述语言。它描述得越精确、越贴近页面真实内容,机器才越可能信你——填错比不填更伤,尤其是 price、availability 这类动态字段,后端没同步更新,搜索引擎抓到过期数据反而降权。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











