hreflang是HTML <link>标签属性，用于声明多语言页面关系；ThinkPHP不自动处理因其属SEO层声明，需手动在<head>中按IETF规范输出，如hreflang="zh-cn"，并确保成组互引、URL可访问、含x-default项。
ThinkPHP 本身不生成 hreflang 标签，必须手动输出或通过模板逻辑拼接，否则 Google 不会识别多语言页面关系。
hreflang 是什么，为什么 ThinkPHP 不自动处理
hreflang 是 HTML <link> 标签的属性，用于告诉搜索引擎：“这个页面是中文版，对应英文版在 /en-us/ 路径”。它不是框架功能，而是 SEO 层面的声明，需按规范显式写入 <head>。ThinkPHP 的 Lang 类只管运行时文本翻译，不干涉 HTML 输出结构，所以 hreflang 必须你来控制。
常见错误现象包括：Google Search Console 提示“未找到 hreflang 声明”、多语言页面被当成重复内容降权、用户从英文搜索结果点进来却看到中文页。
- hreflang 必须成对/成组出现（比如 zh-cn 和 en-us 页面要互相引用）
- 值必须严格匹配 IETF 语言标签（
zh-cn、en-us，不能写zh或english） - URL 必须是完整可访问路径（含协议和域名，或至少是绝对路径
/en-us/）
怎么在 ThinkPHP 模板里安全输出 hreflang
核心思路：获取当前语言 + 所有允许语言列表 + 对应 URL 映射，然后循环生成 <link rel="alternate" hreflang="..." href="...">。
立即学习“PHP免费学习笔记（深入）”；
在 Linux 上通过 Chrome 挂载/VNC 自动发布小红书长笔记。Agent 撰写标题和正文后执行 xhs_publish.sh --publish --submit，触发小红书发布。
推荐做法是在公共模板头部（如 layout.html 或 base.html）中用 {:lang()} 配合 url() 助手函数动态拼接：
<link rel="alternate" hreflang="zh-cn" href="{:url('index/index', ['lang' => 'zh-cn'])}">
<link rel="alternate" hreflang="en-us" href="{:url('index/index', ['lang' => 'en-us'])}">
<link rel="alternate" hreflang="x-default" href="{:url('index/index', ['lang' => config('lang.default_lang')])}">
注意点：
-
url()第二个参数传['lang' => 'en-us']，不是['lang' => lang('en-us')]—— hreflang 值是语言代码，不是翻译后的文本 - 务必加
hreflang="x-default"指向默认语言页，这是 Google 强烈建议项 - 如果用了路由分组（如
Route::group(['prefix' => ':lang'], ...)），url()会自动带前缀；否则需确保生成的 URL 真实可访问（比如/en-us/能返回 200）
如何避免 hreflang 和语言包切换逻辑冲突
hreflang 声明的是“静态页面关系”，而 ThinkPHP 的语言切换（如 ?lang=en-us）是运行时行为。两者混用容易出错：
- 若用 GET 参数切换语言（
?lang=en-us），hreflang 的href也必须带该参数，否则 Google 会认为那是不同页面 - 若用 Cookie 或 Session 切换语言，hreflang 的
href仍需指向带语言前缀或参数的独立 URL，不能依赖后端重定向 - 禁止在 hreflang 中使用相对路径如
./?lang=en-us，必须是完整路径或根路径（/en-us/或/?lang=en-us） - 检查
config/lang.php中的allow_lang_list，hreflang 只应列出其中的语言，多一个少一个都可能触发 Google 报错
验证 hreflang 是否生效的关键检查点
上线后别只看源码，要实测验证：
- 用 Chrome 打开页面 → 右键「查看页面源代码」→ 搜索
hreflang，确认所有语言变体都存在且href可点击访问 - 用 hreflang validator 工具输入任意语言页 URL，看是否解析出完整闭环
- 在 Google Search Console 的「国际化»hreflang»报告」中查看是否有「无效 hreflang」或「孤立页面」提示
- 注意：本地开发环境（
http://localhost）下 hreflang 不会被 Google 抓取，必须部署到真实域名测试
最容易被忽略的是 x-default 的指向和语言代码大小写——ZH-CN 或 zh_CN 都是非法值，必须小写短横线格式（zh-cn）。Google 对这个极其敏感，错一个字符就等于没配。
