实务专题 · 网站交接

双语页面交接:用四条对应关系核验语言URL

合成教学示例。下方网址、观察与结果全部为虚构。离线工具不联网、不发送资料,也不会改你的网站。

语言按钮能点,不等于交接验收完成

验收双语网站,先挑一组确实讲同一主题的中英页面,请供应商提供每页语言注释的原始记录,而不只是语言按钮能打开的截图。本资源把这项小范围验收变成可以复算的四条关系。

有人在2021年8月6日的Google社区问题中询问语言注释报错。这只能证明历史上存在此类问题,不代表当前搜索量,也不描述今天的Search Console界面。这里核验的规则以现行官方文档为准,不照搬旧回复。

已填示例:中文少了一条返回关系

虚构澳洲企业有https://example.test/en/proposal/及https://example.test/zh/proposal/两页。审核者确认它们分别是对应的英文与简体中文内容,使用en-AU与zh-Hans-AU标签。合成观察均记录200状态及2026年10月15日05:00 UTC;两个网址都不是真实客户站点。

记录所在页应有关系错误示例修正示例
英文方案页en-AU → 英文方案页有有
英文方案页zh-Hans-AU → 中文方案页有有
中文方案页en-AU → 英文方案页缺失有
中文方案页zh-Hans-AU → 中文方案页有有

错误输入会输出zh-Hans-AU:en-AU:missing-or-duplicate。需要调查的是这一条返回关系,不是再造一个服务页。修正输入补上记录后输出CONSISTENT;这不是实际生产修复,也不代表Google结果变化。

自己运行同一项检查

下载校验器、错误输入及修正输入,放在同一目录,用Node 22.13或更新版本运行:

node hreflang-edge-check.mjs --test
node hreflang-edge-check.mjs broken.json
node hreflang-edge-check.mjs corrected.json

15项测试覆盖自引用、返回、相对地址、错误对应页、重复标签、缺观察、响应状态、标签大小写及畸形记录。MISMATCH表示记录与约定模型不一致;BLOCKED表示必要证据或支持的输入缺失。结果看打印出的状态,不看进程退出码;这个教学命令行不是可直接接入CI的发布门禁。

程序只读JSON,不抽取HTML或查询DNS。本模型仅支持en-AU/zh-Hans-AU两页,不验证通用语言代码库,也不会判断译文。预期对应表仍须人确认;如果一开始批准了错误对应关系,填齐四条边也可能通过。

官方依据支持到哪里

2026年10月15日核验的Google语言版本文档要求列示自己和对应版本、使用完整URL及返回关系。HTML、HTTP头与sitemap是替代实现方式,不是三套都做就更好。x-default是可选回退,本例不强制第三种语言。

两页范围、JSON输入、200状态验收规则及错误名称属于本资源的教学设计,不是Google规定,也不是索引测试。可达性、跳转、canonical、robots、译文质量与Google实际采用情况,要分别取证。注释不能认证正文语言或保证排名。

交回一个范围明确的验收记录

  1. 先批准一组同主题页面,写清核的是HTML、响应头还是sitemap。
  2. 保存带时间的原始来源及四条观察,未知项保留未知,不虚填成功状态。
  3. 记录准确失败关系、实现负责人及预览重测;不借机改写无关旧页。
  4. 语言可发现性与实际用户路径分开核。表单验收演示处理的是另一项任务:错误提示和模拟接收状态,不验证语言注释。

讨论双语网站时,带脱敏对应表及原始截图/源码,不需要账号密码或客户提交资料。离线记录通过不等于收录、AI推荐、咨询或成交。