ThinkPHP多语言键去重本质是开发规范问题，非技术函数可解决；键重复会导致后加载覆盖前定义，引发翻译失效、显示键名等故障，需通过CI校验、命名空间隔离和MR流程预防。
ThinkPHP 的多语言键值本身不提供去重机制，所谓“去重”其实是避免翻译键重复定义、防止覆盖或冲突——这不是数据库查询去重，而是开发阶段的配置管理问题。
为什么语言键重复会导致问题
ThinkPHP 加载语言包时按顺序合并，后加载的同名键会覆盖前面的。比如 zh-cn.php 和 en-us.php 都定义了 'user.name' => '姓名'，但若两个文件被同时加载（如用 Lang::load() 多次调用），后者可能意外覆盖前者；更常见的是同一语言包内键重复，导致实际生效的只是最后一个。
常见错误现象：
- 部分翻译突然失效，但键名拼写确认无误
- 切换语言后某些文案显示为键名（如显示
user.email而非 “邮箱”） - 执行
Lang::get('user.name')返回空或错误值，查语言文件却发现该键存在
检查语言文件键重复的实操方法
不能靠肉眼扫，得用脚本或工具辅助。推荐在项目根目录运行以下命令（需 PHP CLI 环境）：
立即学习“PHP免费学习笔记（深入）”；
php -r "
$files = glob('lang/*/'.date('Y').'_*.php');
foreach ($files as $file) {
$content = file_get_contents($file);
preg_match_all('/['"]([a-z0-9._]+)['"]s*=>/i', $content, $matches);
$keys = array_count_values($matches[1]);
foreach ($keys as $k => $v) if ($v > 1) echo "$file: $k (x$v)\n";
}"
说明：
- 该命令只扫描当前年份命名的语言文件（如
2026_zh-cn.php），避免旧备份干扰 - 正则匹配单引号或双引号包裹的键名，支持点号分隔（如
'admin.user.list'） - 输出形如
lang/zh-cn/2026_zh-cn.php: user.name (x2)，直接定位重复位置 - 注意：若语言文件用
return ['key' => 'val']形式，此正则有效；若用define()或常量方式，则需另写匹配逻辑
避免键重复的工程实践
靠事后检查不如前置约束。关键不是“怎么删”，而是“怎么不让它出现”：
- 所有新增语言键必须走 MR/PR 流程，CI 中加入
php -l+ 键名唯一性校验脚本 - 禁止在多个语言文件中定义同一业务模块的键（例如
order.status.pending只应在order.php中定义，不分散到common.php或user.php） - 使用命名空间前缀强制隔离：后台用
admin.*，前台用home.*，API 响应用api.*，避免success这类裸键 - ThinkPHP 6+ 支持语言包自动合并，但
Lang::set()若传入关联数组且含重复键，不会报错也不会警告——这点极易被忽略
运行时动态去重没意义，但可做兜底容错
有人想在 Lang::load() 后对整个语言数组做 array_unique()，这是无效的：语言包是嵌套多维数组，array_unique() 只作用于一维值，且会破坏结构。
真正有用的容错只有两种：
- 加载前用
array_keys()+count()检查键是否重复，发现即throw new Exception("Duplicate lang key: {$key}") - 在
Lang::get()封装层加 fallback：当返回值等于键名本身（即未匹配成功）时，记录日志并尝试降级查找（如从user.name试name）
多语言键的“去重”本质是协作规范问题，不是技术函数能解决的。最危险的不是重复定义，而是不同人维护不同文件时，以为自己定义的 button.submit 是全局唯一的，结果上线才发现后台也有一模一样的键、但值是英文——这种冲突不会报错，只会静默覆盖。
