面包屑导航必须使用 itemtype="https://schema.org/BreadcrumbList"，且每个列表项需用 itemprop="itemListElement" 和 itemscope itemtype="https://schema.org/ListItem" 包裹，position 从1连续递增，item 与 name 必须分离标记。
面包屑导航必须用 itemtype="https://schema.org/BreadcrumbList"
不写这个 URI，搜索引擎就无法识别这是结构化数据里的面包屑。常见错误是写成 itemtype="Breadcrumb" 或漏掉 https://，导致 Google Rich Results Test 工具直接报“Missing field ‘@type’”。
实际用法中，itemtype 必须和 itemscope 成对出现，且包裹整个面包屑容器（通常是 <nav></nav> 或 <ol></ol>）：
<nav itemscope itemtype="https://schema.org/BreadcrumbList">
<ol>
<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
<a itemprop="item" href="/"><span itemprop="name">首页</span></a>
<meta itemprop="position" content="1" />
</li>
<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
<a itemprop="item" href="/blog/"><span itemprop="name">博客</span></a>
<meta itemprop="position" content="2" />
</li>
</ol>
</nav>
itemprop="itemListElement" 必须套在每个列表项上
不是套在 <ol></ol> 上，也不是只写一次——每个 <li> 都得带这个属性，否则 Google 会认为只有一条路径，其余被忽略。
-
itemListElement是BreadcrumbList的强制子属性，类型为ListItem - 每个
<li>内必须有独立的itemscope itemtype="https://schema.org/ListItem" -
position值必须从 1 开始连续递增，不能跳号或重复（比如 1、2、4 会失败）
链接和文字必须用 itemprop="item" 和 itemprop="name" 分开标记
很多人把文字直接写在 <a></a> 里，以为 itemprop="item" 能自动提取文本，但 Schema.org 明确要求：链接地址归 item，显示文字归 name，二者不可合并。
立即学习“前端免费学习笔记（深入）”；
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
错误写法：<a itemprop="item" href="/blog/">博客</a> —— 这样 name 属性缺失，验证通不过
正确写法（推荐用 <span></span> 包裹文字）：<a itemprop="item" href="/blog/"><span itemprop="name">博客</span></a>
注意：item 的值必须是有效 URL（相对路径也行，但不能是 # 或空字符串），name 必须是纯文本，不能嵌套其他元素。
动态生成时最容易漏掉 position 和 itemscope 嵌套
后端模板（如 PHP、Jinja、Vue）循环渲染面包屑时，常因变量作用域或条件判断导致某个 <li> 没加 itemscope，或者 position 计数出错。
- 检查最后一项是否意外多套了一层
itemscope（比如外层nav已有itemscope，内部又加） -
position必须用整数，不能是字符串"2"（虽然部分工具容忍，但 Google Search Console 会警告） - 如果页面是单页应用（SPA），需确保 SSR 或客户端注入后，DOM 中真实存在这些属性——JS 动态插入但未触发重新解析，会导致结构化数据不生效
最稳妥的方式：用 Google 的 Rich Results Test 实时粘贴 HTML 验证，别依赖肉眼检查。
