CakePHP切换语言后翻译仍为旧内容，是因为I18n翻译器缓存未清除；需先调用I18n::clear()或I18n::dropTranslator()再setLocale()，才能强制重建translator并加载新.po文件。
__() 在 CakePHP 中切换语言后仍显示旧翻译，不是函数失效，而是翻译缓存没清——I18n 的翻译器（Translator）在首次加载某个 locale 的 .po 文件后会将其内容缓存到内存中，后续调用 __() 不会重新读取磁盘文件，哪怕你已更新了 default.po。
为什么 setLocale() 后翻译还是旧的
CakePHP 的 I18n::setLocale() 只切换当前 locale 标识，但不会自动重载对应语言的翻译资源。翻译器实例（I18n::getTranslator('default')）是单例且惰性加载：第一次调用 __() 时才解析 .po 并缓存结果；之后无论 locale 怎么变，只要 translator 实例没重建，就一直用最初加载的那一份。
- 现象：改完
resources/locales/zh_CN/default.po，执行I18n::setLocale('zh_CN')，__('Hello')仍返回英文 - 验证方式：
debug(I18n::getTranslator('default')->has('Hello'))返回false，说明该字符串根本没被加载进当前 translator - 根本原因：translator 没有“刷新”机制，只有“重建”机制
强制重建 Translator 实例的两种可靠方式
必须让 CakePHP 放弃旧 translator、新建一个绑定新 locale 的实例。以下任一方法都可立即生效：
- 调用
I18n::clear()清空所有 translator 缓存，再调用I18n::setLocale($lang)，随后首次__()就会触发新加载 - 更精准的做法：先
I18n::dropTranslator('default')（只删 default 域），再I18n::setLocale($lang)，避免影响其他自定义消息域 - 注意：不能只调
I18n::setLocale()后立刻__()——必须确保 translator 已重建，所以建议把clear()或dropTranslator()放在setLocale()之前
开发环境自动刷新翻译的最小化实践
在 AppController::initialize() 或语言切换接口中，别只设 locale，要带清除动作：
立即学习“PHP免费学习笔记（深入）”；
use Cake\I18n\I18n;
// 示例：从 session 读语言并强制刷新翻译
$language = $this->getRequest()->getSession()->read('Config.language') ?? 'en_US';
I18n::clear(); // ✅ 关键：清掉旧 translator
I18n::setLocale($language);
debug(__('My Text')); // 此时才会加载 resources/locales/$language/default.po
- 生产环境慎用
I18n::clear()——它会影响所有请求的 translator 缓存，降低性能；开发阶段没问题 - 如果用了自定义消息域（如
__('msg', [], 'admin')），需对应调用I18n::dropTranslator('admin') - 确保
default.po文件已存在且路径正确：resources/locales/{locale}/default.po（CakePHP 4+）
最易忽略的一点：缓存重建只发生在首次 __() 调用时。如果你在 setLocale() + clear() 后没触发任何翻译函数，translator 实际上仍未加载——页面里没出现 __() 的地方，就不会刷新。
