Course结构化数据必须同时使用itemscope、itemtype和itemprop三者嵌套,仅设itemtype无效;name等字段需与可见文本严格一致,provider须嵌套Organization,timeRequired须用ISO 8601格式。

直接用 itemtype 标记课程信息,必须搭配 Schema.org 的 Course 类型,并嵌套在 itemscope 容器内;单独写 itemtype="https://schema.org/Course" 不生效,浏览器和搜索引擎都忽略。
Course 必须配合 itemscope 和 itemprop 使用
Schema.org 的结构化数据不是靠单个属性“打标签”就能生效的,它是一整套嵌套关系。只加 itemtype 没用,必须同时满足三个条件:
-
itemscope:声明一个独立语义区域(比如整个课程卡片) -
itemtype:指定这个区域属于哪一类实体(https://schema.org/Course) -
itemprop:把内部每个字段(如名称、描述、学分)明确绑定到该类型对应的具体属性上
常见错误是只在 <div> 上加 <code>itemtype,但没加 itemscope,结果所有 itemprop 都找不到归属,被完全忽略。
Course 常用 itemprop 字段及取值要求
不是所有字段都能随便填,Course 类型对部分属性有强约束。例如:
立即学习“前端免费学习笔记(深入)”;
-
name:必须是纯文本,不能是链接或带 HTML 标签的内容 -
description:建议不超过 500 字符,过长可能被截断或降权 -
provider:需嵌套另一个itemscope itemtype="https://schema.org/Organization",不能直接写字符串 -
timeRequired:必须用 ISO 8601 持续时间格式,如P12W(12 周)、PT4H30M(4 小时 30 分) -
educationalLevel:推荐用预定义值,如"Intermediate"、"Advanced",避免自造词
实际部署时容易漏掉的兼容点
很多开发者测试时用 Google Rich Results Test 看“通过”,就以为没问题,但上线后仍不展示课程富媒体摘要。原因常出在:
- 页面未被 Google 真实抓取——需检查 robots.txt 是否屏蔽了该路径,或
noindexmeta 标签是否误开 - 课程页缺少主内容区块(如
<main></main>或语义化<article></article>),导致结构化数据被判定为“附属信息”而非核心内容 -
provider或offers缺失:Google 要求至少提供机构或价格信息之一,否则不触发课程类富摘要 - 同一页面混用 JSON-LD 和 Microdata:两者共存时,Google 优先采用 JSON-LD;若 JSON-LD 有语法错误,会静默失效,而 Microdata 又被忽略,等于没标记
真正起作用的 Course 标记,从来不是贴几个属性完事——它得嵌进页面真实的信息流里,且关键字段(尤其是 name、description、provider)必须和 DOM 中用户可见的文本严格一致,差一个空格或标点都可能导致解析失败。



















