codeigniter多语言配置出错导致页面空白，主因是语言文件加载失败且错误被静默屏蔽；需检查路径命名规范、$lang数组定义、加载参数匹配性，开启错误显示并清除缓存定位真实报错。
CodeIgniter 多语言配置出错导致页面空白，通常不是语言包本身的问题，而是加载失败引发致命错误被静默屏蔽（比如 PHP 错误被 @ 抑制或 display_errors 关闭），最终白屏无提示。排查要从“是否真的加载了语言文件”和“加载过程是否中断”两个核心点切入。
检查语言文件路径与命名规范
CodeIgniter 对语言文件位置和命名极为严格：
- 语言文件必须放在
app/Language/zh-CN/（CI4）或application/language/chinese/（CI3）目录下，子目录名（如zh-CN或chinese）必须与$lang参数完全一致，包括大小写和连字符 - 文件名需为
xxx_lang.php格式，例如form_lang.php；内部数组必须命名为$lang，且不能重复定义或漏掉分号 - 在控制器中加载时，使用
$this->lang->load('form', 'zh-CN');，注意第二个参数必须与语言目录名匹配，不能写成zh_cn或Chinese
验证语言类是否启用且未被禁用
CI3 和 CI4 的语言机制不同，容易混淆：
- CI3 中需确认
application/config/config.php中$config['language'] = 'chinese';已设置，且该值与语言目录名一致 - CI4 中语言由
app/Config/App.php的$locale = 'zh-CN';控制，但实际加载仍需手动调用$this->lang->load()；若依赖自动加载，请检查app/Config/Events.php是否注册了正确事件 - CI4 默认不自动加载语言文件，即使设置了
$locale，未显式load()就调用lang('xxx')会触发InvalidArgumentException并可能白屏（尤其在生产环境错误被关闭时）
开启错误显示并捕获真实报错
白屏本质是错误被隐藏，必须让错误浮现：
- 临时修改
public/index.php（CI4）或index.php（CI3），在开头加入：ini_set('display_errors', 1); error_reporting(E_ALL); - 检查 PHP 错误日志路径（
phpinfo()查error_log），重点看是否有Failed opening required（路径错）、Undefined index: lang（数组键不存在）、或Cannot redeclare $lang（重复加载同名语言文件） - 若使用 CI4，运行
php spark serve启动开发服务器，它默认开启详细错误，比 Apache/Nginx 更易暴露语言加载异常
排除缓存与自动加载干扰
CI4 的语言系统依赖服务容器和缓存，CI3 则依赖 language 类单例，缓存残留常导致“看似配置对却无效”：
- CI4：执行
php spark cache:clear清除所有缓存，包括语言文件扫描缓存；再删掉writable/cache手动确认 - CI3：检查
application/cache/下是否有损坏的language_*.php缓存文件，可临时重命名该目录测试 - 避免在多个地方重复加载同一语言包，例如控制器里 load 一次，视图里又 load 一次——CI3 允许，但 CI4 可能因作用域问题报错
