ThinkPHP多语言无法热更新是因为语言包仅在首次调用lang()时加载一次且不监听文件变化；必须在中间件中、SessionInit后路由前调用Lang::setLang()，并确保Cookie键名为think_lang、路径为/，语言目录名全小写且含common.php。
ThinkPHP 多语言无法热更新——不是框架不支持，而是你没在请求生命周期最早期完成语言上下文设置。Lang::setLang() 必须在任何 lang() 调用前执行，且语言包加载只发生一次/请求。
为什么改了 common.php 内容却没生效
ThinkPHP 在单次请求中只加载一次语言包（首次调用 lang() 或 Lang::get() 时触发），后续修改 lang/zh-cn/common.php 文件内容不会自动重载。这不是缓存问题，是设计机制：语言数组被读入内存后就固定了。
- 开发时可临时加
Lang::clear();强制清空已加载的语言项（仅限调试，勿上生产） - 更稳妥的做法是：在中间件里确保
Lang::setLang($lang)执行后，再让业务逻辑走 —— 这样每次请求都走完整加载流程 - 别依赖「改完文件刷新页面就看到效果」，ThinkPHP 不做运行时文件监听
Lang::setLang() 调用时机错位导致热切换失败
常见错误是把 Lang::setLang('en-us') 放在控制器方法里，甚至放在构造函数中。此时 lang('submit') 可能已在中间件或系统行为中提前执行，语言上下文已锁定为默认值。
- 必须在中间件中调用，且该中间件要排在
SessionInit之后、路由调度之前 - 推荐路径：
app\common\middleware\Lang.php中的handle()方法开头就执行Lang::setLang($lang) - 不要在
__construct()或initialize()里设语言 —— 这些钩子晚于语言包加载时机
Cookie 键名、路径不一致导致 Lang 中间件静默失效
ThinkPHP 的 think\middleware\Lang 中间件默认只读 $_COOKIE['think_lang']，且要求 Cookie 的 path 和 domain 与当前请求完全匹配。写错键名或路径，中间件直接跳过切换逻辑，不报错也不提示。
立即学习“PHP免费学习笔记（深入）”；
- 前端切换语言时，必须用
cookie('think_lang', 'en-us')，不能手写setcookie('lang', ...) - 后端写 Cookie 时显式指定路径：
cookie('think_lang', 'en-us', 3600, '/')，避免因子目录路由导致 Cookie 不可见 - 检查浏览器开发者工具 Application → Cookies，确认
think_lang存在且值正确、Path 为/
语言包路径大小写错误或缺失 common.php 导致静默回退
Linux 服务器上 lang/ZH-CN/common.php 和 lang/zh-cn/common.php 是两个不同路径；lang/en-us.php 这种扁平结构也不会被加载 —— ThinkPHP 严格按 lang/{lang-code}/common.php 规则查找。
- 语言目录名必须全小写，如
zh-cn、en-us、ja-jp，大小写敏感 - 每个语言子目录下必须有
common.php（或你配置的分组名，如user.php），且该文件必须以return [...]结束 - 如果
lang/en-us/common.php不存在，Lang::setLang('en-us')仍会成功，但所有lang()调用都会 fallback 到默认语言，无任何警告
真正容易被忽略的是：Lang 中间件只读一次 Cookie，且只在请求初始化阶段加载语言包。改完语言包文件、切完 Cookie、甚至手动调了 Lang::setLang()，只要已有翻译被缓存进当前请求上下文，就不会重新加载 —— 这不是 bug，是性能设计。热更新的唯一可靠方式，就是确保每次请求都从干净状态开始加载。
