hreflang标签仅用于告知搜索引擎多语言页面关系，不触发浏览器跳转或前端语言切换；必须用绝对URL双向互指、符合BCP 47规范，并与html的lang属性严格区分。
link[rel="alternate"][hreflang] 标签**不会触发浏览器自动跳转**，也不参与任何前端语言切换逻辑。它只对搜索引擎爬虫起作用，用于声明多语言页面间的对应关系。
为什么加了 hreflang 用户还是看到英文页
常见错误是以为在中文页里写上 <link rel="alternate" hreflang="en" href="https://example.com/en/">，用户访问中文页后就会“自动切到英文”——完全不会。浏览器根本无视这个标签，也不会修改当前页面内容、lang 属性或 URL 路径。
真实现象：
- 用户从 Google 搜索“中文关键词”点进来，看到的是
https://example.com/zh/页面，但该页的<html lang="en">没改 → 浏览器按英文渲染：标点间距错、中文字体 fallback 失败、屏幕阅读器用英语念中文 - 用户手动把地址栏改成
/en/，结果页面仍是中文文案 → 因为没做真正的多语言内容切换（比如 JS 翻译或 SSR 渲染），只是 URL 前缀变了
hreflang 必须成对互指且用绝对 URL
每个语言版本页面的 <head> 中，都要完整列出所有语言版本（含自己和 x-default），且每条 href 必须是带协议的绝对路径。
立即学习“前端免费学习笔记（深入）”；
正确写法示例（出现在 https://example.com/zh/ 页面中）：
<link rel="alternate" hreflang="zh-Hans" href="https://example.com/zh/"> <link rel="alternate" hreflang="en" href="https://example.com/en/"> <link rel="alternate" hreflang="ja" href="https://example.com/ja/"> <link rel="alternate" hreflang="x-default" href="https://example.com/en/">
关键约束：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 不能用
/zh/或./zh/这类相对路径，爬虫会忽略 - 不能漏掉反向链接：英文页也必须有指向
zh-Hans的<link>，否则 Google 认为“中文版没有对应英文版” -
hreflang="zh-CN"和hreflang="zh-Hans"是两个不同值，别混用；优先选zh-Hans（BCP 47 推荐）
想让用户自动跳转？得靠别的机制
真正实现“根据浏览器 Accept-Language 自动跳转”，要依赖服务端逻辑或前端 JS 判断，与 hreflang 无关。
可行做法：
- 服务端（如 Nginx、Node.js、PHP）读取请求头
Accept-Language: zh-CN,zh;q=0.9，302 重定向到对应语言子目录（/zh/） - 前端 JS 在
document.head加载完后检查navigator.language或navigator.languages[0]，再window.location.href = '/zh' + location.pathname - 注意路径处理：用
location.pathname.replace(/^\/(en|zh|ja)\//, '/' + lang + '/')替换前缀，避免双斜杠或丢失路径段
但必须同步更新 document.documentElement.lang，否则跳转后页面仍按旧语言渲染。
最容易被忽略的闭环验证点
hreflang 关系不是“写了就生效”，它必须形成无歧义闭环：每个语言页都能通过 href 访问到其他所有语言页，且目标页返回 200、包含反向 hreflang、lang 属性匹配内容。
验证手段只有两个：
- Google Search Console 的「国际化报告」，看是否识别出语言组及是否有“未配对”警告
- Screaming Frog 抓取全部语言 URL，导出
hreflang列表，人工比对是否每页都互指、是否全为绝对 URL、是否无重复值
只要其中一页 href 返回 404，或某页漏掉一条反向声明，整组 hreflang 都可能被搜索引擎降权或弃用。
