ThinkPHP语言包本质是返回数组的PHP文件，必须用return返回、禁止输出语句；键名区分大小写且默认不支持点号嵌套；需UTF-8无BOM编码，路径命名须规范，动态设置用Lang::set()，切换语言需Lang::setLocale()。
ThinkPHP 的语言包本质就是 PHP 数组，但必须返回数组、不能 echo 或 var_dump，否则会破坏框架加载流程；语言定义键名区分大小写，且不支持点号嵌套（如 user.login.title 在 TP6 中默认无效，需手动开启或改用下划线）。
语言文件必须用 return 返回数组
语言文件不是普通 PHP 脚本，它被 Lang::load() 或自动加载机制 require_once 包含，执行后需把翻译映射关系作为数组返回。如果误加 echo、print_r 或提前 exit，会导致后续语言读取失败，表现为 lang('xxx') 返回空字符串或原 key。
- ✅ 正确写法（以
zh-cn.php为例）：<?php return [ 'welcome' => '欢迎', 'user_not_found' => '用户不存在', 'data_type_error' => '数据类型错误', ]; - ❌ 错误写法：漏掉
return、末尾多加分号、包含输出语句、使用die()或exit - ⚠️ 注意：数组末尾的逗号可省略，但多人协作时建议保留，避免 git diff 多出无意义变更
关联数组键名不能含点号，除非启用 dot notation 支持
TP6 默认语言解析器不识别 user.login.title 这类带点的键名，直接调用 lang('user.login.title') 会找不到——它只查一级键。若坚持用点号结构，需在配置中显式开启：
- 在
config/lang.php中添加：'parse_key' => true - 或在语言文件里用嵌套数组代替：
return [ 'user' => [ 'login' => [ 'title' => '登录标题', ], ], ]; - 启用后
lang('user.login.title')才能正常工作；但注意性能略低（需递归解析），且部分插件或扩展可能不兼容
动态设置语言变量要用 Lang::set()，且作用域有限
运行时用 Lang::set() 添加或覆盖语言项，适合从数据库读取定制化文案、或根据用户偏好临时注入翻译。但它只对当前请求生命周期生效，不会写入语言文件，也不影响其他请求。
立即学习“PHP免费学习笔记（深入）”；
- 设置单个值：
Lang::set('define2', '语言定义'); - 批量设置：
Lang::set(['error_404' => '页面未找到', 'submit_btn' => '提交']); - ⚠️ 常见坑：在中间件或控制器构造函数中调用
Lang::set()后，若后续又加载了同名语言包（如通过Lang::load()），会覆盖掉动态设置的值 - 获取值始终用
lang('key')或Lang::get('key')，二者等价
多语言切换依赖 locale 配置和语言包路径规范
框架靠 app.lang 配置项决定当前语言，而语言包必须放在指定目录结构下才能被自动发现。路径不对或命名不匹配，lang() 就永远返回 key 本身。
- 标准路径：
lang/zh-cn.php、lang/en-us.php，目录名必须小写、用短横线分隔 - 配置示例（
config/app.php）：'default_lang' => 'zh-cn'，并确保'allow_lang_list' => ['zh-cn', 'en-us'] - 切换语言不能只改配置，要配合
Lang::setLocale('en-us')才真正生效 - ⚠️ 特别注意：语言包文件编码必须是 UTF-8 无 BOM，否则中文会乱码，且错误极难排查
最易被忽略的是语言包文件的编码和 return 语句的完整性——哪怕多一个空格或隐藏字符，都可能导致整个语言系统静默失效，调试时应优先检查这两点。
