hreflang 检测工具:如何验证 hreflang 标签并修复错误
hreflang 告诉搜索引擎应该向谁展示页面的哪个语言或地区版本。思路很简单,实施却很脆弱:每个页面都要列出所有版本,每个版本都要反向列出它,一个错误的代码或一个重定向的 URL 就可能让整组标注变得不可靠。hreflang 检测工具可以一次读取全部内容。
hreflang 检测工具做什么
单个页面的 hreflang 标签说明不了多少。重要的错误只有在页面之间相互比较时才会显现:页面 A 列出了页面 B,那页面 B 列出页面 A 了吗?B 返回 200 吗?B 的 canonical 是它自己吗?所以针对单个 URL 的 hreflang 验证工具适合抽查,而爬虫才是全站的 hreflang 检测工具。
完整的检查会读取每个页面上的标签,跟踪每个目标,并对每一组回答四个问题:
- 每个代码都有效吗?
- 每个页面都列出了自己和其他所有版本吗?
- 每个目标都有回链吗?
- 每个目标都是返回 200、可索引且 canonical 指向自身的 URL 吗?
hreflang 标签如何工作
Google 关于网页的本地化版本的指南介绍了三种声明 hreflang 的方式。每一组选一种。
| 方法 | HTML 页面 | PDF 和文件 | 位置 |
|---|---|---|---|
| link 标签 | ✓ | – | HTML head |
| HTTP Link 响应头 | ✓ | ✓ | 服务器响应 |
| XML 站点地图 | ✓ | ✓ | 站点地图文件 |
1. HTML head 中的 link 标签
<link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
<link rel="alternate" hreflang="en-gb" href="https://example.com/en-gb/pricing/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/pricing/" />
同样的四行要放在全部四个页面上,包括 x-default 那个页面。
2. HTTP Link 响应头
适用于 PDF 和其他没有 HTML head 的文件:
Link: <https://example.com/en/guide.pdf>; rel="alternate"; hreflang="en",
<https://example.com/de/guide.pdf>; rel="alternate"; hreflang="de"
3. XML 站点地图
<url>
<loc>https://example.com/en-us/pricing/</loc>
<xhtml:link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
<xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
</url>
站点地图需要在 urlset 元素上声明 xhtml 命名空间,每个 url 条目都要重复完整的一组。站点地图能让大型组不出现在页面 head 中,但页面变化时很容易被遗忘。
每组 hreflang 都必须遵守的规则
- 自引用。Google 表示,每个版本都必须列出自己以及其他所有版本。
- 回链。如果页面 A 指向页面 B,B 必须指回 A。Google 表示,如果两个页面没有相互指向,这些标签可能会被忽略。
- 完整的 URL。写 https://example.com/de/,而不是 /de/。
- 目标健康。每个目标都应返回 200、可索引,并且 canonical 指向自身。指向重定向、404 或 noindex 页面的标签,是搜索引擎不得不绕开的信号。
- 对应的页面。德语价格页应指向法语价格页,而不是法语首页。
代码遵循固定的标准。Google 在其本地化版本指南中列出了它们:
| 代码 | Standard | 示例 | 有效 |
|---|---|---|---|
| 语言 | ISO 639-1 | de, pt | ✓ |
| 语言和地区 | ISO 3166-1 Alpha 2 | de-at, pt-br | ✓ |
| 语言和文字 | ISO 15924 | zh-Hant | ✓ |
| 只有地区 | 无 | us | – |
| 英国 | 是 GB,不是 UK | en-uk | – |
| 后备 | 保留值 | x-default | ✓ |
x-default:后备版本
x-default 是一个保留值,表示当组内没有任何语言或地区与访客匹配时要显示的页面。Google 建议在语言选择页,以及根据访客语言或位置进行重定向的页面上使用它。
<link rel="alternate" hreflang="x-default" href="https://example.com/" />
它是可选的,但在首页和任何带语言选择器的页面上使用是个好主意。与其他目标一样,x-default URL 应返回 200、可索引且 canonical 指向自身,组内每个页面都应指定同一个 x-default。常见的疏忽是把 x-default 指向按位置重定向访客的 URL,而这个重定向最终落在一个错误页上。
最常见的 hreflang 错误
| 错误 | 表现 | 修复方案 |
|---|---|---|
| 没有回链 | de 漏掉了 en-us | 每组共用一份列表 |
| 没有自引用 | 页面漏掉了自己 | 加上它自己的 URL |
| 地区代码错误 | en-uk | en-gb |
| 只有地区没有语言 | hreflang="us" | en-us |
| 相对 URL | /de/ | 完整的 https URL |
| 目标重定向或出错 | 法语 URL 返回 301 | 最终 URL |
| 目标已 canonical 到其他 URL | 带参数的 URL | canonical URL |
| 一个代码,两个 URL | 两个页面都标为 de | 每个代码一个 URL |
| 标签在 head 之外 | 脚本让 head 提前结束 | 往上移,或改用响应头 |
| 语言不一致 | hreflang 为 fr,html lang 为 en | 与页面文字保持一致 |
SEO ProCheck 的 hreflang 与国际 SEO 实施指南对其中每一项都有更深入的讲解。
hreflang 与 canonical
hreflang 和 canonical 标签相互配合,也很容易相互破坏。每个语言版本的 canonical 都应指向自己。如果德语页面把英语页面设为 canonical,就等于告诉搜索引擎德语页面是重复页面,这与它的 hreflang 相矛盾。canonical 在同一语言内指向;hreflang 跨语言指向。
还要检查 hreflang 组中的每个 URL 是否都是 canonical 版本:协议相同、主机名相同、末尾斜杠一致。一个混用 http 和 https URL、或混用带斜杠和不带斜杠 URL 的组,即使页面本身没问题,也通不过回链检查,因为 URL 并不完全一致。
如何在全站检查 hreflang
- 抓取每个语言版本。如果每种语言都在自己的域名或子域名上,请把它们全部纳入抓取,否则无法检查回链。
- 从您使用的每种方式读取 hreflang:HTML head、HTTP Link 响应头和站点地图。用两种方式声明的组,可能自相矛盾。
- 先验证代码。一个错误的代码被模板重复,就可能影响成千上万个页面。
- 检查每个页面的回链和自引用。
- 检查目标是否健康:每个目标的状态、可索引性和 canonical。
- 找出缺失的组:有其他语言对应页面、却完全没有 hreflang 的页面。
- 在模板或插件层面修复,而不是逐页修复,然后再次抓取。
我们在自己的网站上就是这样做的。neova.app 支持 15 种语言。在 2026年11月20日的 SEO 检查中,它的 XML 站点地图列出了 1,358 个 URL,每条 hreflang 链接都有回链:完全互链。有 15 个版本时,每个页面要列出 15 个 URL(包括它自己),而其中每一个都必须反向列出它。用一份共享列表生成一组中的所有标签,回链自然就有了。
hreflang 组是技术 SEO 诊断清单的第 12 步。如果您的语言版本会重定向访客,也请阅读重定向链指南。
用 Neova 检查 hreflang
Neova 的「国际 SEO」类别显示每个页面的语言和地区版本,以及它们是否相互指向。它从 HTML head 和 HTTP Link 响应头读取 hreflang,为每个 HTML 页面加上「hreflang 语言」和「hreflang 目标」两列,并把 html lang 与 hreflang 及页面自身的文字进行核对。部分检查项:
- 缺少 hreflang 回链 和 缺少 hreflang 自引用
- hreflang 语言代码无效 和 hreflang 国家代码无效
- hreflang 指向非 200 的 URL 和 hreflang 指向已 canonical 到其他 URL 的页面
- hreflang 通用目标失效、noindex、已 canonical 到其他 URL 或不一致
- hreflang 指向语言版本的根目录,而不是对应的 URL
- hreflang 与 html lang 的语言不一致
- 存在其他语言对应页面,却缺少 hreflang
每条标记都会说明为何重要、如何修复以及来源,每个表格都能导出为 CSV 或 Excel,交给修复模板的开发人员。Neova 在所有套餐(包括免费套餐)中运行全部 694 项检查:
| Neova | |
|---|---|
| 运行平台 | |
| 检查项 | 694 |
| 免费套餐 | 每次抓取 1,000 个 URL |
| 界面语言 | 15 |
Mac 指 Apple 芯片;浏览器版是 Neova Online,使用同一个账户。请查看功能、价格或下载 Neova。
常见问题
什么是 hreflang 检测工具?
一种读取网站 hreflang 标签并相互核对的工具:语言和地区代码是否有效、自引用、回链、x-default,以及每个目标是否返回 200、可索引且 canonical 指向自身。
什么是 hreflang 回链?
如果页面 A 把页面 B 列为备用版本,页面 B 也必须列出页面 A。Google 表示,当两个页面没有相互指向时,它们的 hreflang 标签可能会被忽略。
x-default 是必需的吗?
不是,它是可选的。建议在语言选择页、首页,以及按语言或位置重定向访客的页面上使用,这样搜索引擎就知道在没有其他匹配时显示哪个版本。
应该用 en-uk 还是 en-gb?
en-gb。地区部分是 ISO 3166-1 Alpha 2 国家代码,英国的代码是 GB。en-uk 不是有效值。SEO ProCheck 上的 hreflang 与国际 SEO 常见问题中还有更多类似的解答。
哪种 hreflang 方式最好?
三种方式对 Google 都有效:HTML head 中的 link 标签、HTTP Link 响应头或 XML 站点地图。每组只用一种方式。link 标签最容易检查,响应头适合 PDF,站点地图能让大型组不出现在页面中。