使用方法
- 在 语言版本 中每行输入一个版本:语言代码、一个竖线,然后是完整地址。
- 如果您有语言选择器或默认页面,请在 备用地址(x-default) 中输入它的地址。
- 阅读 行的检查结果。显示所有版本都有效后,复制链接元素、站点地图或标头。
- 在每个页面上放入同一组标签,并检查每个版本是否都链接回其他所有版本。
代码如何检查
语言部分必须是 ISO 639-1的两个字母代码,该列表共有183个。可选的地区必须是正式分配的 ISO 3166-1 alpha-2 代码,例如 GB 或 TW。Google 的指南说明只支持这两个标准,并且语言要写在前面,因此单独的地区代码(例如 GB)会被拒绝。
文字系统部分,例如 Hant 或 Hans,必须是四个字母。Google 的指南说文字系统采用 ISO 15924;本工具只检查文字系统的格式,不检查完整列表。代码不区分大小写,因此工具会把语言写成小写,地区写成大写,文字系统写成首字母大写。
- en-uk 会被拒绝,因为 UK 是保留代码;英国的代码是 GB,所以工具会建议 en-GB。
- iw、in 和 ji 在1989年分别改为 he、id 和 yi,因此工具会建议使用这些代码。
- 与任何代码都不匹配的写法,如 xx、eng 或 en_US,会被拒绝,并标出行号。
发送同一组的三种方式
Google 列出三种方法:HTML head 中的链接元素、HTTP 标头和 XML 站点地图。Google 认为三者等效,因此选择最容易维护的一种即可。站点地图形式需要 xhtml 命名空间,并且每个 url 条目都要列出所有备选版本,包括它自己。
HTTP 标头方法适用于任何页面的 GET 响应;Google 称它对 PDF 等非 HTML 文件有用,它的示例也是 PDF。对于网页来说,通常选择链接元素或站点地图。Google 还说,对页面的每个版本返回的 Link 标头都是相同的,因此本工具为整组写出一个值。
互相链接与 x-default
每个版本都必须列出自己和其他所有版本,而且每个页面都必须指回去。Google 的说法是:“如果两个页面没有互相指向,这些标签就会被忽略。”如果难以保持完整,Google 允许某些页面省略部分语言,并且仍会处理彼此指向的配对。
x-default 为与您的任何版本都不匹配的语言指定备用页面。Google 建议把它用于语言选择页,它写作时不带语言代码。
示例:三个版本和一个备用地址
行 en | https://example.com/en/、en-GB | https://example.com/en-gb/ 和 tr | https://example.com/tr/,加上备用地址 https://example.com/,共构成四个备选项。该组的每个页面都获得相同的四个链接元素,站点地图为三个页面各有一个 url 条目。
每个 url 条目都列出全部四个备选项。状态行显示“共3个语言版本,全部有效”,因为备用地址不是语言版本。
| 结果 | 数量 | 详情 |
|---|---|---|
| 链接元素 | 4 | hreflang="tr" href="https://example.com/tr/" |
| 站点地图 url 条目 | 3 | 每个列出4个备选项,包括 x-default |
| Link 标头值 | 1 | 该组每个页面相同,包含4个备选项 |
| 语言版本 | 3 | 状态:共3个语言版本,全部有效 |
常见问题
哪些代码是有效的?
语言代码来自 ISO 639-1,例如 en、tr 或 zh,之后可以跟四个字母的文字系统(如 Hant),以及 ISO 3166-1地区代码(如 GB 或 TW)。代码不区分大小写,工具会写成标准格式。
为什么 en-uk 被报告为错误?
UK 在 ISO 3166-1中是保留代码,Google 的指南也说明 hreflang 中的 UK 不起作用。英国的正式代码是 GB,因此正确的标签是 en-GB。
我需要 x-default 这一行吗?
这一行是可选的。Google 称 x-default 为与您的任何版本都不匹配的语言的备用页面,并建议用于语言选择器。只有当您输入了地址时,工具才会添加它。
每个页面都必须列出整组版本吗?
每个版本都必须列出自己以及其他所有版本。Google 说,两个页面没有互相指向时,标签会被忽略;但它也说可以在某些页面省略某种语言,并且仍会处理彼此链接的配对。
为什么工具只接受 https 地址?
它接受完整的 https 地址,因为现在大多数网站都使用它。Google 要求写明传输方式的完整地址,因此仍在使用 http 的网站需要手动编写这些标注。
HTTP 标头方法是为网页设计的吗?
Google 描述它适用于任何页面的 GET 响应,并称其对 PDF 等非 HTML 文件有用。对于网页来说,通常使用链接元素或站点地图。
这个工具会把我的地址发送到什么地方吗?
不会。结果是根据您输入的文字在浏览器中生成的,不会发送到任何服务器,也不会被保存,您可以自行复制使用。
资料来源
- Google 搜索中心:本地化版本与 hreflang(英文)
- 美国国会图书馆:ISO 639-2代码表,含 ISO 639-1代码(英文)
- Wikipedia:ISO 639-1,183个注册代码(英文)
- Wikipedia:ISO 639 语言代码列表,1989年的代码变更(英文)
- Wikipedia:ISO 3166-1 alpha-2,正式分配的代码,UK 为保留代码(英文)
- Sitemaps.org:协议,实体转义(英文)
数据和文字最近核对于2026年11月10日星期二。