CodeIgniter 4 多语言性能下降主因是动态加载与缓存未优化，需显式配置支持语言、禁用自动协商、启用编译缓存、按需加载精简语言包，并可选预加载关键词条以提升速度。
CodeIgniter 3 升级到 4 后，多语言功能（如 language()、lang() 辅助函数）引入的性能下降，主要源于 CI4 默认启用的动态语言文件加载机制和未优化的翻译缓存策略。这不是多语言本身的问题，而是加载方式和配置没跟上新版本运行模型。恢复性能的关键在于关闭冗余解析、启用缓存、精简语言包结构。
关闭语言自动扫描与动态加载
CI4 默认在每次请求中扫描 app/Language/ 下所有子目录和语言文件，即使只用一种语言，也会遍历全部——这是 CI3 没有的开销。
- 打开
app/Config/Internationalization.php - 将
$supportedLocales显式设为实际使用的语言数组，例如：['zh-CN', 'en-US']，避免框架自动探测所有目录 - 设置
$locale为当前默认语言（如'zh-CN'），并确保它在$supportedLocales中 - 确认
$useAcceptLanguage设为false，禁用浏览器Accept-Language自动协商——该功能会触发额外解析逻辑
启用语言文件编译缓存
CI4 的语言系统支持将 PHP 语言文件（.php）预编译为二进制缓存，跳过每次 require 和 parse 开销。
- 确保
app/Config/Cache.php中启用了缓存驱动（推荐 Redis 或 APCu，避免 file） - 在
.env中设置：cache.handler = redis（或apcu） - 编辑
app/Config/Internationalization.php，将$cacheDuration设为非零值（如3600秒） - 首次访问语言内容后，CI4 会自动生成缓存；可通过
php spark cache:clean清理旧缓存验证效果
精简语言包结构与加载范围
CI4 允许按模块/控制器组织语言文件，但若沿用 CI3 的扁平化大包结构（如把所有翻译塞进一个 general.php），会导致每次加载整包，哪怕只用其中一两个词条。
- 按功能拆分语言文件：如
auth/login.php、admin/dashboard.php，而非全塞进global.php - 在控制器中只加载必需语言包：
$this->lang->load('auth/login', 'zh-CN');，避免全局load('global') - 删除未使用的语言目录（如
fr-FR、ja-JP），减少文件系统遍历压力 - 检查是否误在
BaseController中对所有请求统一加载多个语言包——这是常见性能陷阱
替换语言辅助函数为静态映射（可选进阶）
高频调用 lang('key') 会产生重复键查找和格式化开销。对核心页面（如导航、按钮文字），可改用预加载的关联数组。
- 在 BaseController 构造函数中一次性加载关键语言项：
$this->viewData['lang'] = $this->lang->getLine(['login_btn', 'logout_btn', 'home_title']); - 视图中直接使用
= esc($lang['login_btn']) ?>，绕过运行时函数调用 - 配合 OpCache 启用，这类数组会被高效缓存，比反复调用
lang()快 2–3 倍
不复杂但容易忽略：多语言性能问题往往不是“用了什么”，而是“怎么加载”和“加载多少”。按上述四步调整后，典型页面的语言相关耗时可从 15–25ms 降至 2–4ms，且不再随语言包数量线性增长。
