必须用 https://schema.org/Person,需配合 required 属性 name(纯文本),推荐补充 jobTitle、alumniOf、url(绝对路径)、sameAs;嵌套 Organization 时须用 itemscope 完整包裹;验证通过不等于富摘要上线,需确保数据真实、完整、可公开访问。

itemtype 属性该用哪个 Schema.org 类型
人物简介必须用 https://schema.org/Person,不能用 Organization 或 Thing。用错类型会导致搜索引擎无法识别为人物实体,结构化数据测试工具会报“Missing field 'name'”或直接忽略整个微数据块。
常见错误是复制别人代码时漏掉 https:// 前缀,写成 http://schema.org/Person(已弃用)或 schema.org/Person(无效 URL),浏览器虽不报错,但 Google Rich Results Test 会标为“Unparsable microdata”。
必须配合哪些 required 属性才有效
itemtype="https://schema.org/Person" 单独存在毫无意义——它只是声明类型,真正起作用的是其内部的 itemprop 属性。Google 明确要求至少提供 name,否则不视为有效人物富摘要。
实际部署中建议按需补充以下字段(非全必填,但缺失关键项会影响展示):
立即学习“前端免费学习笔记(深入)”;
-
name:必须,且应为纯文本,避免嵌套链接或<span></span>干扰解析 -
jobTitle或alumniOf:用于职业/教育背景,比空着强 -
url:指向个人主页,需是绝对路径(如https://example.com/jane),相对路径会被忽略 -
sameAs:可填 GitHub、LinkedIn 等权威社交主页,每项一个<link itemprop="sameAs" href="...">
嵌套 itemtype 的典型场景:人物+组织关系
人物常隶属于机构,这时要用 worksFor 或 alumniOf 关联另一个 itemtype="https://schema.org/Organization"。关键点在于:嵌套必须用 itemscope 包裹,且不能跨元素断开。
错误写法(itemscope 和 itemtype 分离):
<div itemscope> <span itemprop="name">张伟</span> <div itemtype="https://schema.org/Organization"><span itemprop="name">某科技公司</span></div> </div>
正确写法(嵌套需完整闭合):
<div itemscope itemtype="https://schema.org/Person">
<span itemprop="name">张伟</span>
<div itemprop="worksFor" itemscope itemtype="https://schema.org/Organization">
<span itemprop="name">某科技公司</span>
</div>
</div>
验证与调试时最容易被忽略的细节
结构化数据生效不等于富摘要上线——Google 有独立审核逻辑。本地验证通过后仍可能失败,原因常藏在这些地方:
- 页面未被 Google 爬取:提交 URL 到 Google Search Console 的“URL 检查”工具强制抓取
-
itemprop值为空或仅含空格:检查模板渲染是否漏传变量,例如<span itemprop="name">{{person.name}}</span>在person.name为null时会输出空标签 - 同一页面存在多个
Person微数据但未加区分:若首页同时展示作者、CEO、客服联系人,建议用itemref显式关联或拆到不同容器,避免语义混淆
真正卡住的往往不是语法,而是数据源是否真实、完整、可公开访问。Schema 标记再标准,背后没数据支撑也没用。



















