ThinkPHP语言包修改后不生效，是因为Lang类将语言数组静态缓存，后续lang()调用直接读内存而非重载文件；开发期可调用Lang::clear()后手动重载，线上应改用JSON动态读取或Redis短TTL缓存。
改完语言包内容后，lang() 依然返回旧值——不是缓存没清，而是 ThinkPHP 默认不会在每次请求时重新加载语言文件，它只在首次初始化时读取并缓存。想让修改即时生效，必须绕过缓存机制或强制重载。
为什么改了 lang/zh-cn/common.php 却不生效
ThinkPHP 的 Lang 类会把已加载的语言包数组缓存在静态属性里，后续调用 lang() 直接从内存取，不再读文件。即使你改了 PHP 文件内容，只要没触发重载逻辑，就永远看不到新文本。
- 开发阶段误以为“改完保存就能看到”，结果刷新页面还是旧翻译
- 线上热更新语言文案（比如运营临时改按钮文字），发现改了文件但用户看不到
- 用
Lang::range()查看当前键值，输出的仍是旧数组，说明根本没重读文件
如何让语言包修改立即生效（开发期）
最直接的办法是清空 Lang 类内部缓存，并强制重载当前语言包。注意：这仅适用于开发环境，线上禁用。
- 在中间件、控制器或调试入口中加这段代码：
think\Lang::clear(); // 清空所有已加载语言包缓存 think\Lang::load(lang_path() . Lang::getLangSet() . '/common.php'); // 手动重载当前语言包
- 确保
lang_path()返回的是正确的路径（通常是APP_PATH . 'lang/'）；如果语言包不在默认位置，需传入绝对路径 - 不要在生产环境使用
Lang::clear()，它会影响并发请求的语言上下文隔离 - 若用了分组语言包（如
user.php），要把common.php换成对应文件名
上线后怎样安全热更新语言文案
线上不能靠清缓存，得靠可预测、无副作用的加载方式。核心是让语言包加载时机可控，且不依赖静态缓存。
立即学习“PHP免费学习笔记（深入）”；
- 把语言包内容转为 JSON 文件（如
lang/zh-cn/common.json），每次请求都用json_decode(file_get_contents($path), true)动态读取——牺牲一点性能，换来 100% 实时性 - 用 Redis 缓存语言包内容，设置较短 TTL（如 60 秒），并在后台提供“刷新语言缓存”接口，由运维手动触发更新
- 避免在
common.php中写复杂逻辑或依赖外部状态，它应纯粹是 return 数组；否则重载时可能出错且难以排查 - 如果你用的是模块化项目，确认重载路径走的是模块
lang/而非应用级lang/，路径优先级会影响实际加载哪个文件
容易被忽略的关键点
很多人卡在“明明 reload 了却还是旧值”，问题往往不在加载动作本身，而在执行时机和作用域。
-
Lang::setLang('en-us')必须在Lang::load()之前调用，否则加载的仍是上一个语言的包 - 中间件里调用
Lang::clear()后，必须紧接着Lang::load()，不能等到控制器再 load，否则lang()第一次调用仍会自动加载旧缓存 - Linux 服务器上
zh-CN和zh-cn是两个目录，改了lang/zh-CN/common.php但当前语言是zh-cn，自然不生效 - 如果语言包里有语法错误（比如少了个
]），require失败会静默跳过，Lang::range()返回空数组——建议加个简单校验：用php -l lang/zh-cn/common.php检查语法
