schema.org 不支持 resume 类型，应使用 person + webpage 组合：person 描述主体并置顶关键属性，webpage 通过 mainentity 指向 person；name、jobtitle、alumniof、sameas、image 为有效字段，telephone 和 email 被忽略。
itemtype 不能直接标记“个人履历主页”——Schema.org 没有 Resume 或 CV 类型，强行写 itemtype="https://schema.org/Resume" 会校验失败，Google 完全忽略。
用 Person + WebPage 组合是最稳妥的起点
个人履历主页本质是“某个人的网页”，不是“一份简历文档”。Person 描述主体（你是谁），WebPage 描述载体（这个 HTML 页面本身）。两者可嵌套，且被 Google、Bing 稳定支持。
-
Person必须出现在能包裹全部个人信息的元素上，比如<main itemscope itemtype="https://schema.org/Person"></main> - 关键属性如
name、jobTitle、alumniOf、knowsLanguage要紧贴Person元素写，不能丢到外层body里 -
WebPage可用于整个页面容器（如），但必须配mainEntity指向内部的Person，否则语义断裂 - 别用
Article：它适用于发布类内容（如博客、攻略），而履历页是身份声明页，Person的字段更贴切、校验更宽松
itemprop 哪些字段真有用，哪些只是摆设
Google 实际提取并展示的字段非常有限。以下字段在富摘要或知识图谱中可能生效，其余多数被静默忽略：
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
-
name→ 必填，影响搜索结果标题显示 -
jobTitle→ 常见于知识面板“职业”栏，支持多值（用多个<span itemprop="jobTitle"></span>） -
alumniOf→ 需嵌套Organization或EducationalOrganization，只写文字无效 -
sameAs→ 支持 GitHub、LinkedIn、Twitter 等权威平台 URL，必须是完整 HTTPS 链接 -
image→ 必须指向可公开访问的 JPG/PNG 图片，尺寸建议 ≥ 200×200px，且需同时设width和height属性 - 别费劲填
telephone或email：Google 明确不索引联系信息以防滥用，填了也不展示
常见错误：URL 格式、嵌套和验证三连崩
微数据失效，90% 出在这三处。不是代码没写，而是写得“像对”实际错。
-
itemtype必须是完整 HTTPS URL，结尾不能有斜杠：https://schema.org/Person✅，https://schema.org/Person/❌，http://schema.org/Person❌ -
itemscope和itemtype必须在同一 HTML 元素上，不能一个在<div>，一个在子 <code><section></section> - 嵌套
Organization时，必须用<div itemscope itemtype="https://schema.org/Organization"> 包裹，并在内部用 <code>itemprop="name"等，不能只靠文本推断 - 务必用 Google Rich Results Test 验证，本地打开 HTML 文件测试无效——工具需要真实可抓取的 URL
真正难的不是写对几个标签，而是让每一段 itemprop 都落在正确的 itemscope 作用域内。一个 div 多包一层或少包一层，整块结构化数据就废了。验证前先手动画 DOM 树，比盲目改代码快得多。
