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" 标注，且内容必须是用户可见的纯文本。

anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载

• ✅ 正确：<nav itemscope itemtype="https://schema.org/SiteNavigationElement"><h2 itemprop="name">主菜单</h2>...</nav>
• ❌ 错误：<nav itemtype="https://schema.org/SiteNavigationElement">...</nav>（缺 itemscope）
• ❌ 错误：<h2 itemprop="name">主菜单</h2> 单独放在 <nav></nav> 外（itemprop 必须在 itemscope 作用域内）
• ❌ 错误：<meta itemprop="name" content="主菜单">（name 不允许仅靠 meta 隐藏提供，必须可见）

导航项（a 标签）要显式用 itemprop="url" 和 itemprop="name"

每个 @#@#@#@#@#@#@#@#@#@0），不能只靠 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 是否绝对、名称是否可见、层级是否闭合——漏掉任意一环，导航结构化数据就等于没存在。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！