lang('xxx')返回原字符串是因为语言包未被识别：lang/目录须在根目录、文件名全小写如zh-cn.php、必须return数组、Cookie名必须为think_lang且domain/path匹配。
ThinkPHP5 多语言切换不是改个配置就能生效，关键卡在三点：Lang::setLang() 必须在任何 lang() 调用前执行、语言包路径必须是小写 lang/zh-cn.php 格式、Cookie 名必须为 think_lang 且 domain/path 匹配。
为什么 lang('xxx') 总是返回原字符串？
这是最常见静默失败——不报错，但翻译没加载。根本原因通常是语言包根本没被框架识别到。
- 检查
lang/目录是否在项目根目录（不是app/lang/或application/lang/），TP5 默认只认根目录下的lang/ - 确认文件名全小写、带连字符：
lang/zh-cn.php✅，lang/zh_CN.php❌，lang/ZH-CN.php❌ - 每个语言文件必须以
return ['key' => 'value'];结尾，不能有额外空格、BOM 头、echo或 HTML 输出 - 如果
lang/en-us.php缺失，lang('welcome')就直接返回'welcome'，看起来像“切成功了”，其实是 fallback 到键名
如何让 URL 参数 ?lang=en-us 真正生效？
TP5 的自动检测只在 CheckLangBehavior 行为触发时运行，而该行为默认依赖 lang_auto_detect 配置和正确注册的 tags。
- 在
config.php中确保开启：'lang_switch_on' => true、'lang_auto_detect' => true、'var_language' => 'lang'（默认就是lang，不用改） - 手动注册行为：在
application/tags.php中添加'app_begin' => ['behavior\CheckLangBehavior']（注意大小写和路径） - 不要在控制器里调
Lang::detect()—— 它只读$_GET['lang']和Accept-Language，且只执行一次；后续改 Cookie 不会重触发 - URL 切换后翻页回退？因为
url()不自动携带当前lang参数，需显式传：url('user/index', ['lang' => cookie('think_lang')])
前端点击切换，后端为什么没反应？
前端设 Cookie 名错了、path 不一致、或后端压根没读这个 Cookie，都会导致切换失效。
立即学习“PHP免费学习笔记（深入）”；
- TP5 默认只读名为
think_lang的 Cookie（不是lang、language或think_var） - 前端 JS 设置必须完整：
document.cookie = "think_lang=en-us; path=/; max-age=31536000"; - 后端接口切换推荐用 PHP 写 Cookie：
cookie('think_lang', 'en-us');（确保已加载 Cookie 类） - 如果用了域名子路径（如
/admin），记得设置cookie('think_lang', 'en-us', ['path' => '/']);，否则 Cookie 只在子路径下可见 - 切完别忘了刷新页面——TP5 一次请求只用一种语言，不会中途热切换
怎么安全地动态切换而不崩掉验证提示？
模型验证器里的错误信息（如 ['email', 'email', '邮箱格式错误']）会在中间件阶段就解析，如果那时语言还没设好，就会用默认语言渲染并缓存，后面再切也无效。
- 务必把语言判定逻辑提到
app_begin行为或自定义早期行为中，早于路由调度和验证器初始化 - 避免在控制器
initialize()或方法里调Lang::setLang()，那时验证规则早已加载完毕 - 如果要用 Session 控制语言，确保 Session 在
app_begin前已启动（检查session_auto_start配置） - 测试时清空浏览器 Cookie 和 ThinkPHP 的 Runtime/cache/ 下 lang 相关缓存文件，避免旧缓存干扰
最易忽略的是：语言包路径硬编码进框架逻辑，一旦放错位置（比如放到模块目录却没配模块 lang 路径）、命名带大小写混搭、或 Cookie 域名不匹配，它都不会报错，只会安静地返回键名——你得靠人工逐项核对路径、命名、Cookie 名、行为注册这四点才能定位问题。
