ThinkPHP不支持语言分组目录结构，需通过Lang::load()手动加载lang/zh-cn/下的user.php等文件，并用lang('key',[],'user')按分组调用；切换语言须Lang::clear()后重载各分组文件，多应用下语言包按模块级>应用级>框架级优先级隔离。
ThinkPHP 本身不支持“语言分组”这个概念——lang/ 目录下的语言包是按语言码（如 zh-cn、en-us）平级存放的，不是按业务模块或功能分组划分的。所谓“语言分组”，其实是开发者对多语言文件做逻辑拆分的一种实践，核心目标是避免 common.php 膨胀、提升可维护性，但必须严格遵循框架加载机制，否则会静默失效。
lang/ 目录下能不能建子目录模拟“分组”？
不能。ThinkPHP 的语言包加载器只扫描 lang/{lang}/ 下的 PHP 文件，且默认只加载 common.php；其他文件（如 user.php、admin.php）不会自动载入，除非你显式调用 Lang::load() 手动引入。
- ✅ 正确做法：在
lang/zh-cn/下放多个文件，比如common.php、user.php、admin.php，然后在中间件或初始化位置按需加载：Lang::load(lang_path() . 'zh-cn/user.php'); - ❌ 错误尝试：建
lang/zh-cn/user/子目录再放common.php——框架根本不会进去看，也不报错 - ⚠️ 注意：
Lang::load()必须在Lang::setLang()之后、首次调用lang()之前执行，否则加载的语言项不会生效
怎么让不同模块用不同语言文件而不互相干扰？
靠“分组名”参数控制加载范围，而不是靠目录结构。ThinkPHP 的 lang() 函数支持第二个参数指定分组名，对应语言包里同名的 PHP 文件。
- 在
lang/zh-cn/user.php中写：return ['login_fail' => '登录失败']; - 在控制器中调用：
lang('login_fail', [], 'user')→ 自动从user.php读取 - 同理，
lang('save_success', [], 'admin')会去找lang/zh-cn/admin.php - ⚠️ 关键限制：分组名必须是合法文件名（不含路径、不带扩展名），且该文件必须存在并返回数组；不存在时
lang()仍返回 key 字符串，无提示
动态切换语言时，已加载的分组语言包会刷新吗？
不会。ThinkPHP 的语言包是单请求内缓存的，Lang::setLang('en-us') 只改变当前语言上下文，不会自动重载所有已加载的分组文件（如 user.php）。你得自己清理并重载。
立即学习“PHP免费学习笔记（深入）”；
- 必须手动清空已有语言项：
Lang::clear(); - 再重新加载目标语言下的各分组文件：
Lang::load(lang_path() . 'en-us/common.php');、Lang::load(lang_path() . 'en-us/user.php'); - ? 建议封装一个
switchLang($lang)方法，在中间件里统一调用，避免漏掉某一分组 - ⚠️
Lang::clear()会清掉所有语言项，包括框架内置的，所以重载顺序很重要：先 common，再各业务分组
多应用（多模块）项目中语言包怎么优先级分层？
ThinkPHP 按路径优先级逐层查找语言包：模块级 > 应用级 > 框架级。如果你用了多应用模式（如 app/admin 和 app/api），每个应用可自带独立的 lang/ 目录。
- 请求进入
admin应用时，会先找app/admin/lang/zh-cn/common.php - 找不到才 fallback 到
app/lang/zh-cn/common.php（应用根目录） - 最后才是框架自带的
thinkphp/tpl/lang/zh-cn.php - ⚠️ 各层级的分组文件（如
user.php）也遵循同样优先级，但不会跨层合并——admin应用里调用lang('xxx', [], 'user')只读app/admin/lang/zh-cn/user.php，哪怕根目录有同名文件也不会叠加
语言包的“分组”本质是加载时机与作用域的控制，不是目录嵌套。最容易被忽略的是：分组文件不会自动加载、切换语言后不会自动刷新、多应用下各层语言包完全隔离——这些都得靠手动 Lang::load() 和 Lang::clear() 补全，框架不替你兜底。
