多语言/多地区站点 hreflang…

当需要审计或生成多语言、多地区网站的 hreflang，并校验语言/地区代码、canonical/协议一致性和国际 SEO 常见错误时使用。

适用场景

解决思路

1. 验证自引用标签：每页必须包含指向自身 URL 的 hreflang 标签；自引用 URL 必须与页面 canonical URL 完全一致；缺少自引用标签会导致 Google 忽略整个 hreflang 集。
2. 验证返回标签：若页面 A 用 hreflang 链接到页面 B，页面 B 必须链接回 A；每个 hreflang 关系必须双向（A→B 和 B→A）；缺少返回标签会使双方 hreflang 信号失效；检查所有语言版本彼此引用形成完整 mesh。
3. 验证 x-default：当存在选择器/回退 URL 时添加 x-default，指定未匹配语言/地区的回退页；通常指向语言选择页或英文版；每组 alternates 只能有一个 x-default；所有其他语言版本也必须返回链接到 x-default。
4. 验证语言代码：使用 ISO 639-1 两字母代码，如 en、fr、de、ja；可选 ISO 15924 脚本子标签是官方机制，如 zh-Hant（繁体）和 zh-Hans（简体），脚本可与地区组合，如 zh-Hans-US 有效；修复常见错误：eng 应改为 en（ISO 639-2 不适用于 hreflang），jp 应改为 ja；zh 虽有效但对脚本特定页面有歧义，优先使用 zh-Hans 或 zh-Hant。
5. 验证地区代码：可选地区限定符使用 ISO 3166-1 Alpha-2，如 en-US、en-GB、pt-BR；格式为 language-REGION（语言小写，地区大写）；单独国家代码无效，不能在没有语言的情况下指定地区；修复常见错误：en-uk 应改为 en-GB，EU/UN 不是有效 ISO 3166-1 值，es-LA 无效（拉丁美洲不是国家，应使用具体国家），避免无语言前缀的地区。
6. 应用 geo-targeting 信号层级：按实用 locale 信号启发式判断 ccTLD > hreflang annotations > server location/IP > addresses/language/currency/Business Profile，但不要声称这是 Google 确认的排名顺序；将 hreflang 视为 hint 而非 directive；不要推荐 locational meta tags 或 HTML geotargeting attributes，因为 Google 忽略它们；不要推荐在 GSC 设置 country targeting，因为 International Targeting report 和 manual country-targeting setting 已在 2022 年移除；hreflang 是剩余杠杆。
7. 处理 EEA、南非、土耳其的区域特定 Search units：当站点通过 hreflang 变体服务这些地区时，在报告中注明业务是 aggregator 还是 direct supplier，并指向区域文档；Google 记录仅在某些国家存在的 Search experiences，包括 aggregator units、supplier units 以及面向 EEA、South Africa、Turkiye 用户的 hotel、flight、long-distance transport、product queries 的 carousels（文档添加于 2026-09-08）；资格和参与按 unit 文档，它们不是排名信号。
8. 验证 canonical URL 对齐：hreflang 只能出现在 canonical URL 上；如果页面有 rel=canonical 指向其他地方，该页 hreflang 会被忽略；canonical URL 与 hreflang URL 必须完全匹配，包括 trailing slashes；非 canonical 页面不应出现在任何 hreflang set。
9. 验证协议一致性：hreflang set 中所有 URL 必须使用同一协议 HTTPS 或 HTTP；混合 HTTP/HTTPS 会导致验证失败；HTTPS 迁移后，将所有 hreflang 标签更新为 HTTPS。
10. 处理跨域支持：hreflang 可跨不同域名工作，如 example.com 和 example.de；跨域 hreflang 需要两个域名都有返回标签；需要监控时使用 Google Search Console verification 或跨站 sitemap submission；跨域设置推荐 sitemap-based implementation。
11. 修复 missing self-referencing tag：添加指向同一页面 URL 的 hreflang。
12. 修复 missing return tags（A→B 但无 B→A）：在所有 alternates 上添加匹配返回标签。
13. 修复 missing x-default（当需要 fallback 行为时）：添加 x-default 指向 fallback/selector page。
14. 修复 invalid language code（如 eng）：使用 ISO 639-1 两字母代码。
15. 修复 invalid region code（如 en-uk）：使用 ISO 3166-1 Alpha-2 codes。
16. 修复 hreflang on non-canonical URL：只把 hreflang 移到 canonical URL。
17. 修复 HTTP/HTTPS mismatch：将所有 URL 统一为 HTTPS。
18. 修复 trailing slash inconsistency：精确匹配 canonical URL 格式。
19. 修复 hreflang in both HTML and sitemap：选择一种方法，大型站点优先 sitemap。
20. 修复 language without region（当需要时）：为 geo-targeted content 添加 region qualifier。
21. 使用 HTML link tags 实现：适合每页少于 50 个 language/region variants 的站点；在 <head> 中放置 <link rel=“alternate” hreflang=“en-US” href=“https://example.com/page” /> 等标签；每页必须包含所有 alternates，包括自身。
22. 使用 HTTP headers 实现：适合非 HTML 文件（PDFs、documents）；通过服务器配置或 CDN rules 设置 Link: <https://example.com/page>; rel=“alternate”; hreflang=“en-US” 等。
23. 使用 XML sitemap 实现：推荐用于大型站点、许多语言变体、跨域设置或 50+ 页面；集中管理但需维护 sitemap。
24. 按方法对比选择实现：小站点（<50 variants）用 HTML link tags；非 HTML 文件用 HTTP headers；大型站点、跨域或 50+ 页面用 XML sitemap；HTML 易实现且源码可见但会膨胀 <head> 并难以大规模维护，HTTP headers 适合 PDF/图片但服务器配置复杂且不在 HTML 中可见，XML sitemap 可扩展集中管理但页面上不可见且需维护 sitemap。
25. 生成流程第 1 步检测语言：扫描站点语言指示符，包括 URL path、subdomain、TLD、HTML lang attribute。
26. 生成流程第 2 步映射页面等价物：匹配跨语言/地区的对应页面。
27. 生成流程第 3 步验证语言代码：对照 ISO 639-1 和 ISO 3166-1 验证所有代码。
28. 生成流程第 4 步生成标签：为每个页面创建 hreflang 标签，包括 self-referencing。
29. 生成流程第 5 步验证返回标签：确认所有关系是双向的。
30. 生成流程第 6 步添加 x-default：为每个页面集设置回退。
31. 生成流程第 7 步输出：生成实现代码（HTML、HTTP headers 或 sitemap XML）。
32. 生成 hreflang sitemap：包含 xmlns:xhtml namespace declaration；每个 <url> entry 必须包含所有语言 alternates（包括自身）；每个 alternate 必须作为单独 <url> entry 出现并带有自己的完整集合；按先到者拆分：50,000 URLs 或 50MB uncompressed 每 sitemap 文件。
33. 生成 Hreflang Validation Report 的 Summary：包含 Total pages scanned、Language variants detected、Issues found（按 Critical、High、Medium、Low 分类）。
34. 生成 Validation Results 表：列为 Language、URL、Self-Ref、Return Tags、x-default、Status，并用 ✅、❌、⚠️ 标记。
35. 生成 Generated Hreflang Tags：按选定方法输出 HTML <link> tags、HTTP header values 或 hreflang-sitemap.xml。
36. 给出 Recommendations：列出缺失实现、需修复的错误代码、方法迁移建议（如 HTML 到 sitemap for scale）。
37. 进行文化适配评估：识别所有语言版本及其目标市场；加载 references/cultural-profiles.md 中相关 cultural profile(s)；检查 CTAs 是否符合文化期望（直接 vs 间接）；检查信任信号是否 locale-appropriate（认证、法律页面）；检查本地化页面是否有外国品牌引用；检查数字/日期/货币格式一致性；将文化适配问题标记为 Medium severity；输出每个语言版本的 Cultural Adaptation Score（0-100）及具体发现。
38. 运行 Content Parity Audit：命令为 /seo hreflang audit <directory-or-url>；加载 references/content-parity.md 获取完整 parity matrix 和 scoring methodology；检查所有声明语言中的页面存在性；检查章节结构等价（H2/H3 数量）；检查 SEO 元素对等（title、meta、schema localization）；验证字数比例（DE 应比 EN 长 25-35%，JA 应短 10-25%）；通过 timestamps 跟踪新鲜度并检测过期翻译；扫描文化标记（外国品牌、错误法律引用、未翻译元素）；输出 Parity matrix table with per-page scores and prioritized action items。
39. 验证 locale 格式：加载 references/locale-formats.md 获取各 locale 的数字、日期、货币、地址、电话格式表；检查数字格式一致性（如 de-DE 页面 “1,000.00” 应为 “1.000,00”）；检查日期格式符合 locale 预期；检查货币符号和位置适合目标市场；检查电话号码使用国际格式和正确国家代码。
40. 按需加载参考文件，不要在启动时全部加载：references/cultural-profiles.md（DACH、Francophone、Hispanic、Japanese cultural adaptation profiles）、references/locale-formats.md（number、date、currency、address、phone format tables per locale）、references/content-parity.md（content parity audit methodology and scoring）。
41. 错误处理 URL 不可达（DNS failure、connection refused）：清楚报告错误；不要猜测站点结构；建议用户验证 URL 后重试。
42. 错误处理未找到 hreflang tags：报告缺失；检查其他国际化信号（subdirectories、subdomains、ccTLDs）；推荐合适的 hreflang 实现方法。
43. 错误处理检测到无效语言/地区代码：列出每个无效代码及正确替换；提供可实施的修正 hreflang tag set。
44. 错误处理某语言没有 cultural profile：使用 cultural-profiles.md 中的 Default Profile checklist；注明评估基于一般指南而非预建 profile。
45. 错误处理 Content parity 目录为空：报告未找到内容文件；建议验证目录路径或提供 URL 进行实时站点分析。

适用边界 · 注意事项

• 单一语言、单一地区且无国际 SEO 需求的站点不需要 hreflang。
• hreflang 是提示而非排名指令，不能替代 canonical、协议一致性、内容质量或搜索单元/排名策略。
• 如果无法访问站点、目录或 URL，或无法控制 canonical/URL 结构，则无法完成完整审计与生成。