hreflang不是a标签的属性，写在a标签上完全无效——浏览器不解析，搜索引擎直接忽略；它仅对head中的link标签有效，且必须成组互指全部语言版本、使用绝对URL、严格符合BCP 47规范，并与html的lang属性保持大小写一致。
hreflang 不是 a 标签该管的事
直接说结论：hreflang 属性在 a 标签上写无效——浏览器不解析，搜索引擎完全忽略，所有你期待的语言识别、SEO 权重传递、自动跳转都不会发生。
它只对 link 标签合法，且必须出现在 <head> 里。你在 <a href="/zh/" hreflang="zh-CN">中文</a> 里加了 hreflang，和没写一样。页面能跳转，靠的是 href；语言关系声明，根本没生效。
真正起作用的 hreflang 必须写在 link 标签里
想让 Google 等爬虫理解多语言页面关系，必须用 <link rel="alternate" hreflang="..." href="...">，且满足以下硬性条件：
- 每页
<head>都要包含**全部语言版本**的声明（含自身和x-default），漏掉任意一个，整组可能被降权或忽略 -
href值必须是**绝对 URL**：https://example.com/zh/✅，/zh/❌，./zh/❌ -
hreflang值必须严格符合 BCP 47：小写、短横线分隔、无空格，如zh-CN、en-US、ja-JP；ZH_CN、chinese、en-uk全部无效 - HTTP/HTTPS 协议必须一致：混用
http://和https://会被当成两个不同页面，关系断裂 - 目标 URL 必须返回
200状态码，且页面实际内容语言要与hreflang值匹配（比如hreflang="zh-CN"指向的页，<html lang="zh-CN">也得是zh-CN）
用户点击切换语言，别碰 hreflang
你要实现“点‘中文’跳到中文页”，就老实用 a 标签的 href：
立即学习“前端免费学习笔记（深入）”；
✅ 正确：<a href="https://example.com/zh/" lang="zh-CN">中文</a>（lang 提升可访问性，不影响跳转）
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
❌ 错误：<a href="https://example.com/zh/" hreflang="zh-CN">中文</a>（hreflang 被丢弃，毫无作用）
如果需要根据用户浏览器语言自动跳转，得用 JS 判断后执行 window.location.href，或者服务端做路由重定向——这些都和 hreflang 无关。
最容易被忽略的细节：lang 和 hreflang 必须对齐
翻车最多的地方不是语法写错，而是逻辑冲突：<html lang="zh-cn"> 和 hreflang="zh-CN" 大小写不一致，Google 会静默忽略整组 hreflang，连报错都不给。
同样，<html lang="en"> 却在 hreflang 里指向中文页，会让爬虫困惑：这页到底是什么语言？结果就是语言关系失效、流量错配。
局部多语言内容（比如英文段落嵌在中文页里）也得单独加 lang，不能指望根节点覆盖——屏幕阅读器和拼写检查全靠这个。
