技能介绍

要解决的问题

hreflang 一旦写错，代价往往不是“排名下降一点”，而是整组信号被 Google 直接忽略。最常见的翻车现场：某语言页面漏了返回标签，导致 A→B 但 B 不回指 A，结果两个页面的 hreflang 全部失效；又比如把 eng 当成语言代码、用 en-uk 代替 en-GB，这些格式错误会让蜘蛛在解析阶段就丢弃整组 alternates。还有站点迁移 HTTPS 后忘了同步 hreflang 里的协议、URL 结尾斜杠与 rel=canonical 不一致，问题都很隐蔽，但影响范围是整个多语言站点。

技能如何工作

该技能围绕校验与生成两条主线展开：

结构校验：检查每个页面是否包含指向自身的标签，且自引用 URL 必须与 canonical 完全一致；确认所有语言版本构成双向闭环，任意两个语言页必须互相回指。
代码校验：语言码必须是 ISO 639-1 两位码，区域码必须是 ISO 3166-1 Alpha-2；简体/繁体应使用 zh-Hans、zh-Hant 脚本子标签，必要时可与区域组合，如 zh-Hans-US。
x-default 检查：当存在语言选择器或兜底页时，应声明唯一 x-default，并确认它同样被其他语言版本回指。
实现方式：支持 HTML <link> 标签、HTTP 响应头、XML sitemap 三种方式，并提供选择建议——小站点用 HTML 标签，PDF 等非 HTML 资源用 header，多语言变体多或跨域场景优先 sitemap。sitemap 还需遵守命名空间声明、每条目必须包含全部语言 alternates、按 5 万 URL 或 50MB 拆分等规则。
内容审计：除了技术层面，还会检查各语言页面的文化适配（CTA 语气、信任信号、本地品牌引用、数字/日期/货币格式）和内容对等（各语言版本是否存在、结构是否等价、词量比例是否合理、翻译是否过期）。

输出是一份结构化报告：问题汇总、按严重度分级的明细表、可直接落地的修正标签集。

适用边界与注意点

hreflang 是提示而非指令，Google 仍会综合其他信号判断。地理位置定向的优先级大致为 ccTLD > hreflang > 服务器位置/IP，但这并非官方确认的排序。
自 2022 年起，Search Console 的 International Targeting 报告与手动国家定向设置已被移除，不要再建议在 GSC 中配置国家定向。
技能默认只输出参考代码与报告；涉及部署、发布等外部写入操作时，会先展示目标与影响并等待确认。URL 不可达时会直接报告错误，不会猜测站点结构。