thinkphp多语言必须集中管控键名、严格校验、提前加载，否则lang()返回原字符串、lang::get()静默失败、验证器提示仍为英文；键名需手动映射，语言包路径文件名须小写短横线，lang::setlang()须在中间件最早期调用。
ThinkPHP 多语言键名不能靠“约定俗成”或“写到哪算哪”，必须集中管控、严格校验、提前加载，否则lang()返回原字符串、Lang::get()静默失败、验证器提示仍是英文——这些都不是配置没生效，而是键名根本没对上。
lang() 和 Lang::get() 的键名必须手动映射，不自动推导
ThinkPHP 不会把错误码 10001 自动转成语言包里的 'param_error'。你得自己维护这个映射关系，常见做法是抽到 config/error_code.php：
return [
'10001' => 'param_error',
'20001' => 'user_not_found',
'30001' => 'token_expired',
];
然后在封装返回时查表：lang($error_config[$code] ?? '')，而不是在控制器里硬写 Lang::get('param_error')。
- 验证器内置规则（如
require、email）走的是validate.php，字段级提示要写成'user_email.email' => '邮箱格式不对'，不能只写'email' => '' - 自定义业务错误码（如
'user_disabled'）必须在所有语言包中保持键名完全一致：zh-cn 和 en-us 下都不能拼错、大小写混用、多空格或漏点 - 如果键不存在，
Lang::get('missing_key')默认返回原字符串'missing_key'，线上静默不报错——这是最常被忽略的“假成功”现象
语言包路径和文件名必须小写+短横线，Linux 下尤其敏感
ThinkPHP 只认 lang/zh-cn/common.php 这种格式，zh_CN、zhcn、zh-cn.php 放在根目录下（而非 config/lang.php）都会被直接忽略，且不报错。
- 语言目录名区分大小写：
zh-CN≠zh-cn，Linux 服务器上一旦写错，整个语言包加载失败 - 文件内必须返回数组：
return ['param_error' => '参数错误'];，不能套一层 locale 键，比如return ['zh-cn' => ['param_error' => '参数错误']]会失效 - 模块化项目中，语言包优先级是：模块
lang/→ 应用lang/→ 框架默认；若模块里没放zh-cn/validate.php，验证器就会 fallback 到应用级或框架级，导致提示不一致
Lang::setLang() 必须在请求最早期调用，中间件是唯一可靠位置
语言切换不是全局状态一设就永久生效，它只对后续的 lang() 或 Lang::get() 调用起作用。中间件没设好、控制器里才调、或者验证器已初始化完再设，都会导致取到默认语言甚至英文。
- 务必在全局中间件（如
app\common\middleware\Lang.php）里读取$request->session('lang', 'zh-cn')并调用\think\Lang::setLang($lang) - 不要在控制器构造函数里设语言——此时中间件还没执行，
Lang状态仍是初始值 - CLI 场景（如命令行任务）没有自动语言侦测，必须显式调用
Lang::setLang('zh-cn')并手动Lang::load()对应文件，否则一律 fallback 到en-us - 静态验证
Validate::check()不触发语言包自动加载，需提前Lang::load(app()->getAppPath() . 'lang/zh-cn/validate.php')
验证器提示、错误码、语言键三者必须分层对齐
验证器提示走 validate.php，业务错误走 message.php 或自定义分组，两者键名体系独立，不能混用。
-
validate.php里字段级提示必须带点号嵌套，如'user.name.require' => '用户名必填'；平铺写法'user_name_require' => ''无效 - 自定义验证规则抛出的异常，若用
throw new ValidateException('10001')，则需确保10001在error_code.php中映射到'user_name.require'，且该键在validate.php中存在对应翻译 - 调试时用
Lang::range()查看当前已加载的所有键值，比翻文件更直接；注意它只返回已加载部分，未加载的语言包不会出现在结果里
最容易被忽略的是「模块级语言包未启用」和「验证器初始化早于语言设置」——这两者叠加，会导致整个请求的验证提示始终是英文，而日志里连 warning 都没有。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
