Lang中间件需显式注册到全局或路由中间件栈，语言包路径须为app/lang/{lang}/xx.php且文件名小写连字符格式，切换语言应调用Lang::setLocale()并校验白名单，Lang::get()异常需检查加载时机与模块级路径。
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 exists -
Lang::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 到默认语言。
