lang()返回键名是因语言文件未加载成功，常见原因包括：文件含bom/空格、非return数组格式、路径大小写错误（如zh-cn.php）、权限不足；lang::load()静默失败不报错，可用dump(lang::getloaded())验证是否加载。
lang() 返回键名而非翻译内容，是不是后缀写错了？
不是后缀问题，ThinkPHP6 语言文件必须是 .php 后缀，不支持 .json、.yml 或其他格式。所谓“后缀识别错误”，其实是框架根本没加载到文件——因为路径、命名或返回结构不符合约定，导致 include 失败后静默 fallback，lang('xxx') 就原样返回键名。
为什么 app/lang/zh-cn.php 加载失败却没报错？
ThinkPHP6 的 Lang::load() 在文件 include 失败时不会抛异常，而是直接跳过，继续用默认语言兜底。常见静默失败原因有：
-
app/lang/zh-cn.php文件开头含 BOM 或空格（哪怕一个换行）→ PHP 解析失败 → include 返回 false - 文件里写了
echo、var_dump或任何非return [...]的执行逻辑 → 导致语法错误或输出中断 - 用了短横线但大小写不对，比如
app/lang/ZH-CN.php或app/lang/zh_CN.php→ Linux 服务器路径不匹配，文件找不到 - 文件权限为只读，或 Web 进程无读取权限 → include 失败但无提示
如何验证语言文件是否被正确加载？
别靠肉眼检查返回值，用最直白的方式确认加载状态：
- 在控制器中加一行：
dump(Lang::getLoaded());—— 如果数组为空或不含zh-cn，说明根本没加载成功 - 临时在
app/lang/zh-cn.php开头加<?php file_put_contents('/tmp/lang_load.log', "zh-cn loaded\n", FILE_APPEND); return [...];，看日志有没有写入 - 用
realpath(config('lang.path') . '/zh-cn.php')打印出实际路径，再手动ls -l确认文件是否存在、可读、无 BOM
注意：TP6 不校验文件后缀名本身，它只按路径拼接后尝试 include；所以写成 zh-cn.txt 会报错，但写成 zh-cn.php 却返回键名，99% 是上述三类低级但难察觉的问题。
多应用下语言文件路径和后缀的硬约束
单应用模式走 app/lang/zh-cn.php，多应用（如 app/admin）必须用 app/admin/lang/zh-cn.php，且不能省略 .php。插件更严格：插件语言包路径如 app/plugin/Pay/lang/zh-cn/common.php，这里的 common.php 是强制约定名，不是后缀问题，而是模块加载机制依赖该文件名。若你写成 zh-cn.php，TP6 会尝试加载 lang/zh-cn.php，但插件的 Lang::load() 默认查的是 common.php，结果就是“文件存在却不用”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
