CodeIgniter 4 的多语言机制彻底重构，不兼容 CI3：语言文件须为 PSR-4 类、置于 app/Language/[locale]/ 下，调用统一用 lang('Key') 函数；CI3 的 $this->lang->line() 等全部失效，迁移需重写而非适配。
CodeIgniter 4 的多语言支持和老版本（尤其是 CI3）完全不兼容，不是简单改配置就能迁移的。核心差异在机制设计、文件结构和调用方式上，必须按 CI4 规范重写，不能沿用旧思路。
多语言机制彻底重构
CI4 不再用 $this->lang->line() 或 language 文件夹下散放的 PHP 数组。它改用基于 语言文件类 的 PSR-4 自动加载体系：
- 语言文件必须放在
app/Language/[locale]/下，如app/Language/zh-CN/General.php - 每个语言文件是一个 PHP 类，继承
CodeIgniter\Language\Language，属性为 public 常量或数组，例如：public $welcomeMessage = '欢迎使用'; - 调用时统一用
lang('General.welcomeMessage')函数，不依赖控制器实例 - 语言包可按模块组织，支持命名空间前缀，如
lang('Auth.login.title')
CI3 代码无法直接复用
以下 CI3 常见写法在 CI4 中会报错或静默失效：
-
$this->lang->load('message');→ CI4 中已移除该类，无对应替代方法 -
language/en/message_lang.php这类路径和文件名格式被废弃 - 手动 include 语言文件、或用
get_instance()->lang获取实例的方式全部无效 - CI3 的
lang()辅助函数不存在，CI4 的lang()是全局函数，参数格式也不同
兼容性关键点：环境与配置
多语言功能依赖运行时环境正确识别 locale，容易踩坑：
- PHP 必须启用
intl扩展（CI4.5+ 强制要求），否则locale切换失败，回退到默认语言但无提示 -
app/Config/App.php中的$negotiateLocale = true控制是否自动根据浏览器 Accept-Language 切换，设为 false 时需手动设置$locale - CLI 环境下
lang()默认返回英文，需显式调用service('language')->setLocale('zh-CN') - CI4.5 起新增
spark lang:find命令，可扫描视图和控制器中未定义的语言键，避免漏翻译
升级老项目时的实际建议
若从 CI3 迁移多语言逻辑，不要尝试“兼容层”或封装适配器，维护成本高且易出错：
- 先提取 CI3 所有
lang()调用点，整理成键名清单（如form.email_required） - 按新目录结构创建对应语言类文件，把原数组内容转为 public 属性
- 全局搜索替换：将
$this->lang->line('xxx')改为lang('xxx') - 检查所有视图中硬编码中文的地方，一并纳入语言文件管理
- 利用
spark serve --watch+ 热重载，边改边验证各 locale 下文字是否正常显示
