微格式验证需三步:先用Google Rich Results Test检查SEO支持的结构化数据,再用DevTools核对class/rel拼写与嵌套层级,最后用mf2py或Microformats2 Inspector确认是否符合microformats2标准。

用 Google Rich Results Test 验证微格式是否被识别
微格式(如 h-card、h-entry)本身不触发浏览器渲染变化,肉眼无法判断是否写对;必须依赖结构化数据验证工具。Google 的 Rich Results Test(现整合进 Search Console 的「富媒体结果测试」)仍是目前最直接、反馈最准的在线工具——它会解析 HTML 中所有支持的微格式(含 microdata、JSON-LD 和部分 microformats),并明确标出识别到的实体类型与字段。
注意:Rich Results Test 对纯微格式(如 h-event)支持有限,仅识别 Google 明确文档中声明支持的子集(例如 h-card 中的 p-name、u-url 等常用属性)。未被识别不等于语法错误,可能是该属性暂未纳入 Google 的解析器白名单。
浏览器开发者工具里查 class 层级和 rel 属性是否拼写正确
微格式依赖特定的 class 值(如 h-card、p-name)和 rel 值(如 author、u-url),大小写、连字符、空格全敏感。DevTools 的 Elements 面板能快速暴露常见硬伤:
-
class="hcard"→ 错,应为class="h-card" -
class="p name"→ 错,应为class="p-name"(中间是连字符,不是空格) -
rel="u-url"用在上但 href 缺失 → 解析失败 - 嵌套层级断裂:比如
p-name不在h-card内部,而是平级 → 不会被关联为姓名字段
建议右键检查元素后,在 DevTools 中直接编辑 class 值实时观察变化,比反复刷新更高效。
用 Microformats2 Parser 扩展或命令行工具做本地深度解析
Google 工具偏重 SEO 场景,而微格式规范本身(microformats.org)定义了一套通用解析规则。要确认 HTML 是否符合 microformats2 标准(即能否被任意支持 mf2 的服务消费),得用专用解析器:
- Chrome 扩展
Microformats2 Inspector:安装后点击图标,自动高亮所有已识别的h-*类型,并展开属性树 - 命令行用
mf2py:pip install mf2py<br>mf2py --url https://example.com
或传本地文件:mf2py --html-file index.html
输出 JSON,可清晰看到解析出的items数组和每个properties键值对 - 关键点:
mf2py会把class="h-card h-as-card"解析为两个独立 item,而 Google 工具只认第一个 —— 这种差异常导致“本地能解析,线上不显示”的困惑
避免 class 名被 CSS 或 JS 覆盖或动态移除
微格式解析发生在 HTML 解析阶段,但很多前端框架(React/Vue)或 CMS 主题会在加载后通过 JS 清除、重写或条件渲染 class。典型表现是:初始 HTML 源码里有 class="h-card",但 DevTools 的 Elements 面板里看不到——说明已被 JS 干掉。
排查方法:
- 右键「查看网页源代码」(View Page Source),搜索
h-card,确认原始 HTML 确实存在 - 在 DevTools 的 Elements 面板中右键对应节点 → 「Break on」→ 「Attribute modifications」,看是否有 JS 在运行时删改
class - CSS 中若写了
.h-card { display: none }不影响解析,但若用了content: ""或伪元素覆盖文本,可能干扰某些解析器对文本内容的提取
微格式真正脆弱的地方不在语法,而在「它安静地躺在 HTML 里,却很容易被前端流程无意擦除」——检查时务必锁定是源码层有效,而非渲染后状态。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











