itemtype必须使用Schema.org官方定义的完整HTTPS URL，如https://schema.org/Person；禁止HTTP、缺协议、带fragment、末尾斜杠、版本号或自定义后缀；嵌套时各层级需独立声明完整URL；避免微数据与JSON-LD混用同一实体。
itemtype 必须用 Schema.org 官方定义的完整 URL
itemtype 的值不是随便写的字符串，也不是缩写或别名，必须是 Schema.org 上某个类型（如 Person、Article）对应的标准 URI。浏览器和结构化数据工具（如 Google Rich Results Test）只认这个确切地址。
常见错误是填成：http://schema.org/Person（HTTP 协议）、schema.org/Person（缺协议）、https://schema.org#Person（用了 fragment，无效）——这些都不被识别。
- ✅ 正确写法：
https://schema.org/Person - ✅ 正确写法：
https://schema.org/Recipe - ❌ 错误写法：
http://schema.org/Person（Google 已明确要求 HTTPS） - ❌ 错误写法：
https://schema.org/Person/（末尾斜杠会 404，URL 不匹配）
嵌套 itemtype 时，每个层级都要独立写完整 URL
HTML 中允许嵌套 itemscope，但每个 itemtype 都得单独指定完整地址，不能“继承”或省略。比如一个 Person 里嵌套 Organization，就得分别写两个 itemtype 属性。
<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>
注意：itemprop="worksFor" 是属性映射关系，不改变 itemtype；子元素的 itemtype 仍需显式声明为 https://schema.org/Organization，不能靠父级推断。
立即学习“前端免费学习笔记（深入）”；
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
不要用微数据 + JSON-LD 混合定义同一实体
如果页面已用 <script type="application/ld+json"></script> 声明了 Article，就别再在 HTML 标签里用 itemtype="https://schema.org/Article" 重复标记同一内容。两者语义冲突或字段不一致时，搜索引擎可能忽略微数据，甚至报错 Conflicting types。
- 优先选 JSON-LD：更灵活、不污染 HTML 结构、支持复杂嵌套
- 微数据适合简单场景（如评论、面包屑），且必须确保
itemtype和 JSON-LD 中的@type完全一致（大小写、拼写、协议、路径） - 验证工具（如 Rich Results Test）会把不同来源的同名实体当冲突处理，尤其
url或sameAs不一致时
Schema.org 类型 URL 不支持版本号或自定义后缀
有人试图加版本（如 https://schema.org/Person/v2）或本地命名空间（如 https://example.com/schema/Person），这会让所有结构化数据解析器直接失效。Schema.org 的设计就是扁平、无版本、全局唯一。
如果你需要扩展字段（比如加个内部工号 employeeId），只能：
- 用
additionalProperty包装（标准方式） - 或在 JSON-LD 中用自定义命名空间（但要配
@context，且微数据不支持） -
itemtype本身绝不能改，必须严格保持为https://schema.org/XXX
最常被忽略的一点：即使你只改了一个字母（比如 https://schema.org/Artical），整个 itemtype 就变成无效类型，所有 itemprop 都失去上下文，等同于没标。
