语言文件报错主因是PHP语法污染或ThinkPHP加载机制不匹配：文件含BOM/空格导致parse error；返回值非数组或结构非法；路径命名不符约定（如app/lang/zh-cn.php）；LoadLangPack中间件未启用或调用时机过早。
语言文件返回数组报错，基本是 PHP 语法或 ThinkPHP 加载机制不匹配导致的——不是语言包内容写错了，而是文件本身没被当成 PHP 执行，或者返回值结构不符合框架预期。
语言文件开头有 BOM 或空格导致 parse error
ThinkPHP 要求语言文件必须是纯 PHP 文件，以 return []; 结尾，且不能有任何输出。一旦文件开头存在 UTF-8 BOM、空行、echo、var_dump 或注释前的不可见字符，PHP 解析时就会直接报 Parse error: syntax error, unexpected 'return' 或更隐蔽的 Cannot use object of type think\lang\Lang as array。
- 用 VS Code 或 Sublime Text 打开
app/lang/zh-cn.php，右下角确认编码为 “UTF-8 without BOM” - 删除文件最开头的所有空行、空格、
<?php前的任何字符 - 确保第一行就是
<?php，最后一行是return [/* ... */];，中间无print、die、header等语句 - Linux 下可用
head -n1 app/lang/zh-cn.php | hexdump -C检查是否有 EF BB BF（BOM）
语言文件返回值不是数组或结构非法
ThinkPHP 的 LoadLangPack 中间件会调用 include 该文件，并期望得到一个数组。如果返回了 null、string、object，或数组里嵌套了闭包、资源、未定义变量，就会在后续 array_merge 或遍历时触发 Fatal error 或 TypeError。
- 检查语言文件是否写了
return "hello";或return $lang;（而$lang未定义） - 禁止在语言文件中使用
require/include、__DIR__、env()等动态逻辑——它必须是静态数组 - 避免使用 PHP 8.1+ 不兼容写法，例如
return [...$base, 'key' => 'val'];中$base为null，应改用return ($base ?? []) + ['key' => 'val']; - 简单验证方式：在命令行运行
php -l app/lang/zh-cn.php，看是否提示语法错误
语言包路径或命名不符合 ThinkPHP 6 约定
ThinkPHP 6 不会自动扫描任意路径下的 PHP 文件。它只认固定格式的路径和文件名，一旦错位，就会静默跳过加载，最终 lang('xxx') 返回键名本身，或在调试开启时抛出 InvalidArgumentException: Lang item not exists。
立即学习“PHP免费学习笔记（深入）”；
- 路径必须是
app/lang/zh-cn.php（单应用）或app/api/lang/en-us.php（多应用），不能是app/lang/zh_CN.php、lang/zh-cn.php或app/lang/zh-cn/index.php - 语言标识必须全小写 + 短横线，
zh-cn✅，ZH-CN❌，zh_CN❌，zh❌ - 确认
config/lang.php中'allow_lang_list' => ['zh-cn', 'en-us']包含该标识，且大小写完全一致 - 如果用了自定义语言检测逻辑（如从 URL 参数取值），检查是否返回了带空格或斜杠的非法字符串，比如
zh-cn/或zh-cn
中间件未启用或 lang() 调用时机错误
LoadLangPack 是语言包加载的唯一入口，它必须在请求生命周期早期执行。如果中间件没注册、被条件跳过、或 lang() 在中间件执行前就被调用（如在配置文件、服务提供者、或全局常量定义中），就会因语言包未加载而报错。
- 检查
app/middleware.php是否包含'think\middleware\LoadLangPack'，且位置在其他业务中间件之前 - 不要在
config/目录下的 PHP 文件中直接调用lang('xxx')——此时框架尚未启动，语言系统不可用 - 模板中使用
{:lang('welcome')}是安全的，但控制器构造函数、initialize()方法里调用需确保LoadLangPack已执行（TP6.0.14+ 通常没问题，老版本建议延迟到index()再用） - CLI 场景（如
php think hello）默认不加载该中间件，需手动Lang::load(...)或在命令类中显式初始化
最易被忽略的是语言文件本身的执行环境——它看起来只是个数组，实则是一段会被 include 执行的 PHP 代码。任何微小的语法污染、类型越界、路径偏差，都会在框架最底层炸开，且错误堆栈往往不指向语言文件本身。动手前先 php -l 扫一遍，比翻日志快十倍。
