ThinkPHP多语言报错主因是路径配置错误而非内容问题，需严格遵循APP_PATH/lang/{lang}/{module}.php规则，注意大小写、连字符及.php后缀要求。
ThinkPHP 多语言文件找不到：路径配置和命名规则
报错 Lang not exists 或 Language file not found，基本是路径没对上，不是语言包内容写错了。
ThinkPHP 加载语言文件时，会按 APP_PATH/lang/{lang}/{module}.php 拼路径（5.1+ 默认结构），其中 {lang} 是当前语言标识（如 zh-cn），{module} 是模块名（如 common、index）。注意大小写和连字符 —— zh_CN 和 zh-cn 是两个不同目录，TP 默认用后者。
-
APP_PATH必须指向真实入口所在的应用目录（比如./app/），不是thinkphp/核心目录 - 语言包文件必须是
.php后缀，且返回一个数组，不能有输出、不能用echo或print - 如果在多模块应用中使用，
index.php对应的语言文件应放在app/lang/zh-cn/index.php，而不是app/lang/zh-cn.php - 自定义语言目录？改
config/lang.php中的range和path，但别动allow_auto，自动探测容易绕过你的配置
ThinkPHP 语言变量不生效：数组键名与调用方式不匹配
写了 return ['hello' => '你好'];，但 lang('hello') 还是输出 hello —— 很可能是语言包没被加载，或者键名用了非法字符。
ThinkPHP 的 lang() 函数只认纯字母、下划线、点号组成的键名。像 'user.name' 可以，'user-name' 或 '用户名称' 会直接忽略。另外，语言包必须在控制器/模板执行前加载，否则变量查不到。
立即学习“PHP免费学习笔记（深入）”；
- 检查是否在
app/lang/zh-cn/common.php里定义了对应键，且该文件被lang('common')或自动加载机制引入 - 调试时可临时加
dump(\think\Lang::getLoaded());看当前已加载哪些语言文件 - 模板中用
{:lang('hello')}，别写成{:lang('hello')|default='hello'}—— default 会覆盖语言查找逻辑 - CLI 环境下语言包默认不加载，需手动调用
\think\Lang::load()
ThinkPHP 切换语言失败：session / cookie 和 lang 参数冲突
点了切换按钮，URL 带上了 ?lang=zh-cn，但页面还是英文 —— 很可能 session 或 cookie 里存了旧语言，覆盖了 URL 参数。
ThinkPHP 默认优先级是：session > cookie > URL 参数 > 配置默认值。如果你之前登录过、存过 think_lang session，那 URL 改了也没用。
- 清空 session：删掉
runtime/session/下对应文件，或调用Session::delete('think_lang') - 想强制用 URL 参数？在
config/lang.php中设'detect' => false，并确保'var_lang' => 'lang' - 注意中间件顺序：如果用了多语言中间件，它必须在 SessionMiddleware 之后运行，否则读不到 session
- Apache 下开启
mod_rewrite后，带?lang=的 URL 可能被重写丢弃，检查路由规则是否拦截了 query 参数
ThinkPHP 多语言性能问题：大量小文件 + 重复加载
每个模块都配一堆 zh-cn/*.php，请求一多，file_exists + include 就成瓶颈 —— 特别是在没有 OPcache 或开发环境关了缓存时。
语言包本质是 PHP 数组，TP 每次都重新 require，没法像类一样被 OPcache 优化到极致。大项目建议合并或预编译。
- 把多个模块语言合并到
common.php，用命名空间式键名，比如'admin.user.delete' => '删除用户' - 上线前用
php think optimize:lang（TP6）或自写脚本把所有语言包 dump 成单个 PHP 文件，然后改lang.path指向它 - 避免在循环里反复调用
lang()，提前赋值给变量；lang('key', ['name' => $name])的占位替换比字符串拼接稍慢，简单场景直接用sprintf - 注意：TP5.1 不支持语言包热更新，改了文件要清
runtime/lang/缓存目录，否则永远读旧内容
最常被忽略的是 runtime 目录权限和缓存残留 —— 改完语言配置，不删 runtime/lang/，TP 就一直用缓存的“假路径”去加载，根本不会报错，只会静默失效。
