Lang::set() 在控制器中无效，因其调用过晚——语言包已在应用初始化阶段加载固化；必须在全局中间件 handle() 开头设置语言，并确保路径正确（如 app/lang/en-us/common.php）、区分大小写，且不混淆 Lang::set() 与 Config::set()。
Lang::set() 在 ThinkPHP6 中手动调用后没反应，基本是因为它被调用了但语言包早已加载完毕——翻译内容（比如验证器提示、系统错误、模板中 lang() 调用）在中间件执行前就固化了，Lang::set() 只影响之后的新调用，对已加载部分完全无效。
为什么控制器里调 Lang::set() 没用
ThinkPHP6 的语言包加载发生在应用初始化阶段（think\App::init() 后、路由调度前），此时 validate.php、common.php 等语言文件已被读入内存并绑定到默认语言上下文。控制器执行时，这些资源早已“定型”。
- 典型表现：
throw_exception(L('VALIDATE_ERROR'))仍输出中文，哪怕你刚在控制器里执行了Lang::set('en-us') - 验证器类是静态初始化的，其
$rule和$message数组在控制器实例化前就完成了语言绑定 -
Lang::set()不会重载已加载的语言包，也不会触发Lang::load()，只是改当前请求的 locale 标识
必须在中间件 handle() 开头设置语言
真正起效的时机只有一个：在任何语言相关逻辑执行前，也就是全局中间件的 handle() 方法最开头。这里能确保所有后续 lang()、Lang::get()、验证器、系统异常都基于新语言环境。
- 打开
app/middleware.php，确认已注册think\middleware\LoadLangPack（不是Lang） - 新建自定义中间件（如
app/middleware/LangDetect.php），在handle()第一行读取来源并设语言：public function handle($request, \Closure $next) { $lang = $request->cookie('think_lang', 'zh-cn'); // 或从域名解析：$host = parse_url($_SERVER['HTTP_HOST'], PHP_URL_HOST); $lang = $map[$host] ?? 'zh-cn'; \think\Lang::set($lang); return $next($request); } - 把该中间件加到
app/middleware.php全局数组顶部，确保它比LoadLangPack更早执行（顺序很重要）
语言包路径和命名必须严格匹配
Lang::set('en-us') 成功不代表语言包真被加载——框架会按约定路径去找，路径错、大小写错、文件名错，都会静默跳过，lang('hello') 就直接返回键名。
立即学习“PHP免费学习笔记（深入）”；
- 路径必须为
app/lang/en-us/common.php（单应用）或app/api/lang/en-us/common.php（多应用），不能是app/lang/en_US/或lang/en/ - 文件名必须全小写 + 短横线：
en-us.php✔️，EN-US.PHP❌，en_US.php❌ -
common.php必须以return ['hello' => 'Hello'];形式返回纯数组，开头不能有 BOM、空格、echo或注释 - Linux 服务器区分大小写，本地开发用 Windows 测试通过 ≠ 线上生效
别混淆 Lang::set() 和 Config::set('lang.default_lang')
这两个方法作用完全不同，混用会导致预期外行为：
-
Lang::set('en-us')：只改当前请求的语言上下文，不影响后续请求，也不写 Cookie -
Config::set('lang.default_lang', 'en-us')：改的是框架默认语言配置，用于域名切换等需“提前覆盖初始化值”的场景（如在middleware.php的handle()开头或provider.php中） - 如果想让域名
en.example.com直接加载英文包，必须用Config::set()，且必须在LoadLangPack加载前完成；Lang::set()此时已太晚 - Cookie 写入要单独做：
cookie('think_lang', 'en-us', ['path' => '/', 'expire' => 31536000])，Lang::set()不会自动同步
最关键的细节是：语言包加载是一次性动作，时机不可逆。修复失效问题，核心就三点——设得早（中间件开头）、路径对（小写短横线）、不混淆 set() 和 Config::set()。其他所有“看起来设了但没变”的现象，基本都卡在这三处之一。
