Lang中间件没生效？检查是否注册到全局中间件栈
ThinkPHP 的 Lang 中间件不会自动启用，必须显式注册。常见错误是只配置了语言包路径，但忘了在 app/middleware.php 或路由定义里加它。
实操建议：
若需全站生效，把 think\middleware\Lang 加入 app/middleware.php 的全局中间件数组若只对某组路由生效，用 ->middleware(Lang::class) 显式绑定（注意命名空间）别在控制器构造函数里手动调用 Lang::detect() —— 中间件已做这事，重复调用可能覆盖检测结果
语言包文件找不到？确认目录结构和命名规范
ThinkPHP 按 lang/{lang}/xx.php 查找语言包，其中 {lang} 是小写、无下划线的 locale 标识（如 zh-cn、en-us），不是 zh_CN 或 zh。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
访问时提示 Language file not existsLang::get(‘hello’) 始终返回键名而非翻译值
实操建议：
语言包路径默认为 app/lang/，确保文件存在且权限可读文件名必须是 zh-cn.php、en-us.php 等，不能是 zh_CN.php（系统会转成小写连字符格式）文件内返回关联数组，键名不加前缀，例如：return [‘hello’ => ‘你好’];，不是 return [‘zh-cn’ => [‘hello’ => ‘你好’]]
多语言切换失败？别直接改 $_GET[‘lang’]，要用 Lang::setLocale()
很多人试图通过 URL 参数 ?lang=ja-jp 手动设置语言，但 Lang 中间件默认只从 Accept-Language 头或配置项读取，不解析 GET 参数。
使用场景：需要用户点击切换语言，或带语言参数的分享链接。
实操建议：
在中间件或控制器中提前调用 Lang::setLocale($lang)，例如从 input(‘lang’) 获取后校验再设务必校验输入值，只允许白名单中的语言标识，避免目录遍历或无效 locale 导致后续异常设完后记得调用 Lang::load()（通常自动触发，但手动设 locale 后保险起见可显式调）注意：Lang::setLocale() 不会修改 session 或 cookie，如需持久化，得自己存到 session 并在中间件里读取
Lang::get() 返回空或原键名？检查语言包加载时机和作用域
语言包加载依赖于当前请求的语言环境和模块路径。最常被忽略的是「模块级语言包」未启用，或 Lang 中间件执行顺序靠后导致控制器里调用时还没加载。
性能与兼容性影响：
语言包是 PHP 文件，每次加载都涉及一次 include，高频调用 Lang::get() 本身开销不大，但错配语言包路径会导致 warning 并拖慢响应5.1 和 6.x 对 lang 目录位置约定不同：5.1 默认 lang/ 在应用根目录，6.x 默认在 app/lang/，混用容易漏载
实操建议：
调试时加一行 dump(Lang::range()); 看当前已加载哪些语言项确保 Lang 中间件在路由解析之后、控制器执行之前运行（默认顺序通常满足，但自定义中间件栈要留意）如果用了多模块，语言包需放在对应模块的 lang/{lang}/ 下，否则只认应用级语言包
复杂点在于语言环境判定和包加载是分阶段的，中间件、配置、输入参数、session 四者优先级容易搞混；最容易被忽略的是模块级语言包路径没按规范放，或者 locale 字符串含非法字符导致静默 fallback 到默认语言。
评论(0)