itemtype唯一合规值是https://schema.org/SiteNavigationElement，必须与itemscope同元素出现，配合itemprop="name"（用户可见文本）和各链接的itemprop="url"/"name"，且需服务端直出HTML。
itemtype 必须用 https://schema.org/SiteNavigationElement，不能简写或拼错
描述网页导航栏时，itemtype 唯一合规的值是 https://schema.org/SiteNavigationElement。这不是可选项，也不是“差不多就行”的字符串——写成 SiteNavigationElement、schema.org/SiteNavigationElement、http://schema.org/SiteNavigationElement 或末尾多加斜杠（如 https://schema.org/SiteNavigationElement/）都会导致 Google Rich Results Test 显示 “No structured data detected”。该类型专为导航链接集合设计，语义明确，且被主流搜索引擎实际支持。
必须配合 itemscope 和 itemprop="name" 才能被识别
itemtype 单独存在完全无效，它必须和 itemscope 出现在同一 HTML 元素上；同时，导航区域本身需要一个可读的名称（比如“主菜单”“快捷入口”），这个名称要用 itemprop="name" 标注，且内容必须是用户可见的纯文本。
- ✅ 正确：
<nav itemscope itemtype="https://schema.org/SiteNavigationElement"><h2 itemprop="name">主菜单</h2>...</nav> - ❌ 错误：
<nav itemtype="https://schema.org/SiteNavigationElement">...（缺itemscope） - ❌ 错误：
<h2 itemprop="name">主菜单</h2>单独放在<nav>外（itemprop必须在itemscope作用域内） - ❌ 错误：
<meta itemprop="name" content="主菜单">（name不允许仅靠meta隐藏提供，必须可见）
导航项（a 标签）要显式用 itemprop="url" 和 itemprop="name"
每个 <a> 链接不是自动继承父级 itemtype 的。若想让搜索引擎理解“这是导航里的第几个入口”，每个链接都得单独标注：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
-
itemprop="url"：必须为完整、可访问的 HTTPS URL（如https://example.com/about），相对路径（/about）或锚点（#contact）不被解析为有效导航目标 -
itemprop="name"：取链接的可见文本内容（如<a href="/products" itemprop="url"><span itemprop="name">产品中心</span></a>），不能只靠title或aria-label - 避免嵌套多个
itemprop="name"在同一个链接里（如 span + svg + text），会导致解析歧义或字段丢失
常见失效原因：SPA 动态注入的导航不会被索引
如果你用 React/Vue 等框架在客户端渲染导航栏（比如通过 useEffect 或 mounted 插入 DOM），即使 HTML 源码里写了正确的 itemscope 和 itemtype，Google 也不会抓取到——因为它只解析首屏服务端返回的原始 HTML，不执行 JS 后续插入的 Microdata。
立即学习“前端免费学习笔记（深入）”；
- ✅ 可行方案：SSR（Next.js Pages Router、Nuxt 2）、SSG（Hugo、Astro 静态生成）或预渲染（Prerender.io）确保导航结构存在于初始 HTML 中
- ❌ 无效方案：在
componentDidMount里用innerHTML注入带itemtype的导航 HTML - ⚠️ 注意：Lighthouse 或 Rich Results Test 工具验证时，务必查看“源代码”（View Page Source），而非 Elements 面板里 JS 渲染后的结果
itemtype”，而在于整个微数据块是否从服务端直出、URL 是否绝对、名称是否可见、层级是否闭合——漏掉任意一环，导航结构化数据就等于没存在。 
