hreflang 检查器

hreflang 的第一部分必须是双字母的 ISO 639-1 语言代码。其他任何写法均不被支持，且该注解会被搜索引擎直接忽略 —— 静默失败，没有任何报错。

修复: 改用双字母语言代码。若原意是指定国家/地区，请记住语言代码必须在前：如 de-AT，而非单独的 AT。

来源: Google Search Central — Localized versions of your pages

可选的第二部分必须是双字母的 ISO 3166-1 alpha-2 地区代码。「en-UK」是最典型的错误：IANA 注册表中根本没有 UK 这个条目（英国的国家代码是 GB），导致整条注解被搜索引擎静默丢弃。

修复: 改用正式分配的地区代码：en-GB。

来源: Google Search Central — Localized versions of your pages

单凭国家代码不是有效的 hreflang 值。Google 明确指出不会从国家推导语言，因此用「us」或「de」代表某个国家时，无法命中任何预期的定位。

修复: 将语言写在前面：如 en-US、de-DE。

来源: Google Search Central — Localized versions of your pages

该值的结构不符合「language」或「language-region」规范。在代码语言环境标识符中常见的下划线（如 en_US）在此处无效。

修复: 改用连字符连接：如 en-US。

来源: Google Search Central — Localized versions of your pages

每个语言版本都必须在注解中列出自身以及所有其他版本。遗漏当前页面自身的注解集被视为不完整，Google 会将其判定为不可信并整体忽略。

修复: 添加一条 href 指向本页自身 URL 的 link 标签。

来源: Google Search Central — Localized versions of your pages

同一个语言-地区代码出现了多次，分别指向不同的 URL。搜索引擎无法在冲突的页面之间做出选择，导致整组注解失去可信度。

修复: 每个语言-地区代码仅保留一个目标 URL。

来源: Google Search Central — Localized versions of your pages

同一个 URL 被多个语言-地区代码同时使用。当一个页面确实服务于多个区域时属于合法用法，但更常见的是模板生成代码时的复制粘贴失误。x-default 不受此规则限制：Google 明确指出 x-default 可以直接指向默认语言版本页面。

来源: Google Search Central — Localized versions of your pages

x-default 指定了当访问者的语言/地区未匹配任何已列出版本时的默认展示页面。缺少此项时，超出覆盖范围的访问者将完全由搜索引擎自行决定呈现哪个页面。

修复: 添加一条 x-default 注解，指向语言选择器页面或最通用的版本页面。

来源: Google Search Central — Localized versions of your pages

hreflang 的 href 属性必须是完整的绝对 URL。相对路径的解析取决于页面的服务上下文，而这恰恰违背了注解消除歧义的初衷。

修复: 改用包含协议与域名的完整绝对 URL。

来源: Google Search Central — Localized versions of your pages

Google 要求所有版本必须相互回指，否则会整体忽略注解。确认互指需要抓取其他页面，而本工具完全在浏览器本地运行，不发起任何网络请求。本工具提供的是所有页面都应携带的同一份规范注解块，从结构上确保双向互指成立。

来源: Google Search Central — Localized versions of your pages

所有 hreflang 值语法合法、包含当前页面的自引用，且值与 URL 之间不存在冲突。

来源: Google Search Central — Localized versions of your pages