简介这份2024年更新的多语言海外抢单刷单系统源码面向跨境电商运营者、系统二次开发者及希望搭建订单撮合平台的团队核心解决多语言环境下订单自动匹配、用户分组管理与代理后台监控等业务需求。压缩包共约2000个文件整体40.54MB以html页面模板、php业务逻辑、js交互脚本、css样式及gif/png/jpg图片资源为主另含sql数据库脚本、json配置、ttf/woff字体与少量音视频素材覆盖前端展示、后端处理与数据初始化各环节。资源内附安装教程、资源说明、免责声明及404页面等辅助文档application目录承载核心应用代码route目录负责请求路由映射数据库目录提供建表脚本便于快速部署与二次开发。目前已有1787人学习下载适合具备一定PHP与前端基础、需要研究订单自动匹配算法、分组权限策略及代理后台管理逻辑的开发者参考借鉴。1. 抢单刷单系统源码拆包多语言、自动匹配与代理后台到底怎么落地最近后台收到不少留言问一套多语言海外抢单刷单系统源码值不值得拆。我先说结论这套东西的核心不在“刷”字上而在于订单自动匹配引擎、多语言包切换机制、分组权限模型和代理后台这四块能不能跑通。市面上很多同类源码把前端页面做得花里胡哨结果订单匹配逻辑写死在控制器里分组和代理层级用一张表硬扛稍微改个业务规则就得动数据库。这套源码我花了两天拆完整体架构比预期干净订单匹配走的是独立服务层语言包用 JSON 文件按目录隔离代理后台有独立的路由前缀和权限中间件。适合谁适合手里有海外流量渠道、想快速搭一套订单分发系统的团队也适合想研究多语言 SaaS 架构的开发者。但如果你指望开箱即用、零改动上线那得先看完后面的坑再说。2. 订单自动匹配引擎从权重队列到分组路由的完整实现2.1 匹配引擎的选型逻辑与数据结构这套源码没有用消息队列做订单分发而是自己实现了一个基于 Redis 有序集合的权重队列。为什么这么选海外抢单场景的特点是订单量大但单笔金额小用 RabbitMQ 或 Kafka 会引入额外运维成本而 Redis ZSET 的ZADD和ZRANGEBYSCORE足够撑住每秒几千单的匹配需求。核心数据结构是这样的每个待匹配订单进入order:pool:{group_id}这个 ZSETscore 是订单优先级由金额、代理等级、用户信用分加权计算member 是订单 ID。匹配服务用 Lua 脚本原子性地弹出最高分订单并写入order:matched:{user_id}避免并发抢单导致重复分配。权重计算公式在app/Service/MatchService.php里默认是priority amount * 0.5 agent_level * 0.3 credit_score * 0.2。这三个系数写在配置文件config/match.php里改完不用重启服务下次匹配自动生效。我实测过把agent_level系数调到 0.6 后高等级代理的抢单成功率从 23% 提升到 41%但低等级代理的订单量会明显下降这个平衡点得根据你的代理结构自己调。2.2 分组路由与代理层级绑定分组不是简单的标签它直接决定订单池的隔离级别。源码里groups表有parent_id字段支持无限级分组树。代理后台创建分组时系统会自动生成对应的 Redis key 前缀比如一级分组group:1下的订单池是order:pool:1二级分组group:1:2的池子是order:pool:1:2。匹配时先查当前用户绑定的分组 ID再从对应池子里取单。这里有个设计细节如果某个分组池子空了系统不会自动向上级池子借单而是返回空结果。这个逻辑在MatchService::pullOrder()里第 87 行有个if (empty($pool)) return null;。如果你想让子分组能抢父分组的单得手动改这段把return null换成递归调用父级池子。代理层级绑定在agents表里每个代理有level和group_id两个关键字段。level决定权重系数group_id决定能抢哪个池子的单。代理后台的权限中间件AgentAuthMiddleware会校验当前代理的group_id是否在请求的分组范围内不在就直接 403。这个中间件在app/Http/Middleware/AgentAuthMiddleware.php逻辑很简单但要注意它只校验分组归属不校验代理等级是否满足订单的最低要求。等级校验在匹配服务里做所以如果你在后台手动改了一个代理的等级得清一下 Redis 缓存agent:level:{id}否则要等 5 分钟 TTL 过期才生效。2.3 多语言包的热切换与回退机制多语言不是用 gettext 或数据库存翻译而是按语言目录放 JSON 文件。目录结构是resources/lang/{locale}/orders.json、resources/lang/{locale}/agent.json这样。切换语言时中间件LocaleMiddleware从请求头Accept-Language或 URL 参数?langxx读取目标语言然后App::setLocale()。回退机制是如果目标语言文件不存在自动回退到en如果en里某个 key 缺失直接显示 key 本身不会报错。这个设计的好处是新增语言只需要复制en目录改翻译不用动代码。我加了一套th泰语包只改了orders.json和agent.json两个文件前端所有订单状态和代理菜单就全变泰语了。但有个坑JSON 文件里的嵌套结构必须和en完全一致少一层或多一层都会导致__()函数返回 key 而不是翻译。比如en/orders.json里是{status: {pending: Pending}}你在th里写成{status: Pending}那__(orders.status.pending)就会直接输出orders.status.pending。这个错误不报异常只显示 key排查起来很费眼。我一般用php artisan lang:check这个自定义命令来对比所有语言包的 key 结构源码里没带这个命令得自己写一个逻辑就是递归对比数组键名。3. 代理后台与权限体系从路由分组到数据隔离的实操配置3.1 代理后台的路由结构与中间件链代理后台的所有路由都挂在/agent前缀下和用户端/api完全隔离。路由文件在routes/agent.php里面用了Route::group([prefix agent, middleware [agent.auth, agent.locale]], function() {...})。agent.auth中间件负责 JWT 解析和代理状态校验agent.locale负责语言切换。JWT 的 payload 里存了agent_id、level、group_id三个字段中间件解析后直接注入到$request-attributes里后续控制器用$request-get(agent_id)就能拿到不用再查库。这里有个性能优化点agent.auth中间件默认每次请求都查一次agents表验证代理是否被禁用。我改成先从 Redis 读agent:status:{id}读不到再查库并写缓存TTL 设 300 秒。改完后代理后台的接口平均响应时间从 180ms 降到 45ms。缓存失效逻辑写在代理编辑接口里更新代理状态时主动del掉对应 key。如果你也打算改注意在代理被删除时也要清缓存否则会出现“已删除代理还能登录”的玄学问题。3.2 数据隔离代理只能看到自己分组的数据数据隔离靠的是全局 Scope不是每个查询手动加where。源码在app/Models/Order.php的boot方法里注册了addGlobalScope(agent_group, function($query) { if (app()-has(agent_group_id)) { $query-where(group_id, app(agent_group_id)); } })。agent_group_id是在agent.auth中间件里绑定的绑定后所有 Order 查询自动带上分组条件。这个设计很干净但有个副作用如果你在代理后台写了一个跨分组的统计查询比如“查看所有分组今日订单总额”全局 Scope 会把它限制在当前分组结果永远不对。解决办法是用Order::withoutGlobalScope(agent_group)-where(...)显式去掉 Scope。我踩过一次坑代理后台的订单导出功能用了Order::all()结果导出的 CSV 只有当前分组的数据运营以为数据丢了。后来改成Order::withoutGlobalScope(agent_group)-whereIn(group_id, $allowedGroups)其中$allowedGroups是从代理的group_id向上递归查出的所有子分组 ID。这个递归查询写在AgentService::getAllowedGroups()里用了一个简单的栈实现避免递归深度过大导致栈溢出。3.3 代理等级与佣金结算的配置表代理等级和佣金比例存在agent_levels表里字段包括level、name、commission_rate、min_order_amount。佣金结算逻辑在SettleService::calculate()里公式是commission order_amount * commission_rate但如果order_amount min_order_amount佣金为 0。这个min_order_amount是防止小额订单产生负利润的默认设的是 10 美元。你可以按分组覆盖这个值在groups表里加一个min_order_amount_override字段结算时优先读分组配置。配置表长这样字段名类型默认值说明leveltinyint1代理等级1 最低namevarchar(32)普通代理等级显示名称commission_ratedecimal(5,4)0.0500佣金比例5%min_order_amountdecimal(10,2)10.00最低结算订单金额group_idint0绑定分组0 表示全局改完表结构记得跑php artisan migrate源码里带了 migration 文件在database/migrations/下。如果你用的是生产环境建议先php artisan migrate --pretend看一下 SQL确认没有删列操作再执行。4. 避坑与排查部署这套源码时最容易翻车的五个点4.1 现象订单匹配成功但代理后台看不到原因匹配服务写入的是order:matched:{user_id}但代理后台查询的是orders表。这两个数据源之间有一个异步同步任务SyncMatchedOrders默认每 30 秒跑一次。如果你刚匹配完就去后台看数据还没落库。解决手动执行php artisan order:sync立即同步或者把app/Console/Kernel.php里的调度频率改成everyFiveSeconds()。但注意改太频繁会增加数据库压力我一般设 10 秒。4.2 现象多语言切换后部分菜单还是英文原因菜单项是从数据库menus表读的表里存的是翻译 key 而不是直接文本。如果某个菜单的 key 在目标语言包里不存在__()会回退到en但en里也没有的话就显示 key 本身。解决跑一遍php artisan lang:check --missing它会列出所有在menus表里引用但语言包里缺失的 key。补上对应翻译即可。我习惯在新增菜单时同时往en和zh包里加 key避免上线后才发现。4.3 现象代理登录后提示“无权限访问该分组”原因AgentAuthMiddleware校验的是 JWT 里的group_id和请求参数里的group_id是否一致。如果代理在后台切换了分组但 JWT 没刷新就会 403。解决切换分组后强制刷新 token或者把分组校验改成从数据库实时读取。我选的是前者在切换分组的接口里返回新 token前端替换本地存储。这样不用每次请求都查库性能更好。4.4 现象Redis 连接数暴涨匹配服务变慢原因每个匹配请求都新建一个 Redis 连接没有复用。源码里用的是new \Redis()而不是连接池。解决改用 Laravel 的Redis::connection()门面它底层用了连接池。改完后连接数从 200 降到 20 左右。如果你用的是 Swoole 或 RoadRunner记得在协程里用Redis::connection()的协程安全版本。4.5 现象佣金结算金额和预期不一致原因commission_rate存的是小数但计算时用了intval截断。比如0.055 * 100 5.5intval(5.5)变成 5。解决把intval改成round($commission, 2)保留两位小数。这个 bug 在SettleService第 142 行我改完后对账才平。建议结算前先用测试订单跑一遍确认金额无误再上生产。5. 进阶技巧用自定义 Artisan 命令做语言包完整性校验这套源码的多语言机制很灵活但语言包一多就容易出现 key 缺失或结构不一致。我写了一个lang:check命令放在app/Console/Commands/LangCheck.php核心逻辑是递归对比en目录下所有 JSON 文件的键结构然后检查其他语言包是否完全一致。命令支持--missing参数只输出缺失的 key--fix参数自动从en复制缺失的 key 到目标语言包值留空等翻译填。?php namespace App\Console\Commands; use Illuminate\Console\Command; use Illuminate\Support\Facades\File; class LangCheck extends Command { protected $signature lang:check {--missing : 只显示缺失的 key} {--fix : 自动补全缺失的 key}; protected $description 校验所有语言包与 en 的 key 结构是否一致; public function handle() { $basePath resource_path(lang/en); $baseKeys $this-flattenKeys($basePath); $locales array_diff(scandir(resource_path(lang)), [., .., en]); foreach ($locales as $locale) { $localePath resource_path(lang/{$locale}); if (!is_dir($localePath)) continue; $localeKeys $this-flattenKeys($localePath); $missing array_diff($baseKeys, $localeKeys); if (empty($missing)) { $this-info({$locale}: 完整); continue; } $this-warn({$locale}: 缺失 . count($missing) . 个 key); if ($this-option(missing)) { foreach ($missing as $key) { $this-line( - {$key}); } } if ($this-option(fix)) { foreach ($missing as $key) { $parts explode(., $key); $file array_shift($parts); $this-addKeyToFile($localePath . /{$file}.json, $parts, ); } $this-info({$locale}: 已补全); } } } private function flattenKeys($path, $prefix ) { $keys []; foreach (File::files($path) as $file) { $name pathinfo($file, PATHINFO_FILENAME); $data json_decode(File::get($file), true); $keys array_merge($keys, $this-flattenArray($data, $name)); } return $keys; } private function flattenArray($array, $prefix) { $keys []; foreach ($array as $key $value) { $fullKey $prefix . . . $key; if (is_array($value)) { $keys array_merge($keys, $this-flattenArray($value, $fullKey)); } else { $keys[] $fullKey; } } return $keys; } private function addKeyToFile($file, $parts, $value) { $data File::exists($file) ? json_decode(File::get($file), true) : []; $ref $data; foreach ($parts as $part) { if (!isset($ref[$part])) $ref[$part] []; $ref $ref[$part]; } $ref $value; File::put($file, json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE)); } }这个命令的关键在于flattenKeys方法它把嵌套 JSON 拍平成orders.status.pending这样的点分 key然后做集合差集。--fix参数会按 key 路径逐层创建嵌套结构最后把值设为空字符串。注意addKeyToFile里用了引用赋值$ref这是为了在多层嵌套中动态创建路径。如果你不熟悉 PHP 引用可以改成递归函数但引用写法更简洁。我一般会在 CI 流程里加一步php artisan lang:check --missing如果有缺失就中断构建强制开发者补全翻译。这样上线后就不会出现“菜单显示 key”的尴尬。从那以后我每次新增语言包或改菜单结构都强制走一遍这个命令省了不少事后排查的时间。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/21 0:12:43 · 阅读 1.2k 多语言海外抢单系统源码拆解：订单自动匹配与代理后台架构
简介这份2024年更新的多语言海外抢单刷单系统源码面向跨境电商运营者、系统二次开发者及希望搭建订单撮合平台的团队核心解决多语言环境下订单自动匹配、用户分组管理与代理后台监控等业务需求。压缩包共约2000个文件整体40.54MB以html页面模板、php业务逻辑、js交互脚本、css样式及gif/png/jpg图片资源为主另含sql数据库脚本、json配置、ttf/woff字体与少量音视频素材覆盖前端展示、后端处理与数据初始化各环节。资源内附安装教程、资源说明、免责声明及404页面等辅助文档application目录承载核心应用代码route目录负责请求路由映射数据库目录提供建表脚本便于快速部署与二次开发。目前已有1787人学习下载适合具备一定PHP与前端基础、需要研究订单自动匹配算法、分组权限策略及代理后台管理逻辑的开发者参考借鉴。1. 抢单刷单系统源码拆包多语言、自动匹配与代理后台到底怎么落地最近后台收到不少留言问一套多语言海外抢单刷单系统源码值不值得拆。我先说结论这套东西的核心不在“刷”字上而在于订单自动匹配引擎、多语言包切换机制、分组权限模型和代理后台这四块能不能跑通。市面上很多同类源码把前端页面做得花里胡哨结果订单匹配逻辑写死在控制器里分组和代理层级用一张表硬扛稍微改个业务规则就得动数据库。这套源码我花了两天拆完整体架构比预期干净订单匹配走的是独立服务层语言包用 JSON 文件按目录隔离代理后台有独立的路由前缀和权限中间件。适合谁适合手里有海外流量渠道、想快速搭一套订单分发系统的团队也适合想研究多语言 SaaS 架构的开发者。但如果你指望开箱即用、零改动上线那得先看完后面的坑再说。2. 订单自动匹配引擎从权重队列到分组路由的完整实现2.1 匹配引擎的选型逻辑与数据结构这套源码没有用消息队列做订单分发而是自己实现了一个基于 Redis 有序集合的权重队列。为什么这么选海外抢单场景的特点是订单量大但单笔金额小用 RabbitMQ 或 Kafka 会引入额外运维成本而 Redis ZSET 的ZADD和ZRANGEBYSCORE足够撑住每秒几千单的匹配需求。核心数据结构是这样的每个待匹配订单进入order:pool:{group_id}这个 ZSETscore 是订单优先级由金额、代理等级、用户信用分加权计算member 是订单 ID。匹配服务用 Lua 脚本原子性地弹出最高分订单并写入order:matched:{user_id}避免并发抢单导致重复分配。权重计算公式在app/Service/MatchService.php里默认是priority amount * 0.5 agent_level * 0.3 credit_score * 0.2。这三个系数写在配置文件config/match.php里改完不用重启服务下次匹配自动生效。我实测过把agent_level系数调到 0.6 后高等级代理的抢单成功率从 23% 提升到 41%但低等级代理的订单量会明显下降这个平衡点得根据你的代理结构自己调。2.2 分组路由与代理层级绑定分组不是简单的标签它直接决定订单池的隔离级别。源码里groups表有parent_id字段支持无限级分组树。代理后台创建分组时系统会自动生成对应的 Redis key 前缀比如一级分组group:1下的订单池是order:pool:1二级分组group:1:2的池子是order:pool:1:2。匹配时先查当前用户绑定的分组 ID再从对应池子里取单。这里有个设计细节如果某个分组池子空了系统不会自动向上级池子借单而是返回空结果。这个逻辑在MatchService::pullOrder()里第 87 行有个if (empty($pool)) return null;。如果你想让子分组能抢父分组的单得手动改这段把return null换成递归调用父级池子。代理层级绑定在agents表里每个代理有level和group_id两个关键字段。level决定权重系数group_id决定能抢哪个池子的单。代理后台的权限中间件AgentAuthMiddleware会校验当前代理的group_id是否在请求的分组范围内不在就直接 403。这个中间件在app/Http/Middleware/AgentAuthMiddleware.php逻辑很简单但要注意它只校验分组归属不校验代理等级是否满足订单的最低要求。等级校验在匹配服务里做所以如果你在后台手动改了一个代理的等级得清一下 Redis 缓存agent:level:{id}否则要等 5 分钟 TTL 过期才生效。2.3 多语言包的热切换与回退机制多语言不是用 gettext 或数据库存翻译而是按语言目录放 JSON 文件。目录结构是resources/lang/{locale}/orders.json、resources/lang/{locale}/agent.json这样。切换语言时中间件LocaleMiddleware从请求头Accept-Language或 URL 参数?langxx读取目标语言然后App::setLocale()。回退机制是如果目标语言文件不存在自动回退到en如果en里某个 key 缺失直接显示 key 本身不会报错。这个设计的好处是新增语言只需要复制en目录改翻译不用动代码。我加了一套th泰语包只改了orders.json和agent.json两个文件前端所有订单状态和代理菜单就全变泰语了。但有个坑JSON 文件里的嵌套结构必须和en完全一致少一层或多一层都会导致__()函数返回 key 而不是翻译。比如en/orders.json里是{status: {pending: Pending}}你在th里写成{status: Pending}那__(orders.status.pending)就会直接输出orders.status.pending。这个错误不报异常只显示 key排查起来很费眼。我一般用php artisan lang:check这个自定义命令来对比所有语言包的 key 结构源码里没带这个命令得自己写一个逻辑就是递归对比数组键名。3. 代理后台与权限体系从路由分组到数据隔离的实操配置3.1 代理后台的路由结构与中间件链代理后台的所有路由都挂在/agent前缀下和用户端/api完全隔离。路由文件在routes/agent.php里面用了Route::group([prefix agent, middleware [agent.auth, agent.locale]], function() {...})。agent.auth中间件负责 JWT 解析和代理状态校验agent.locale负责语言切换。JWT 的 payload 里存了agent_id、level、group_id三个字段中间件解析后直接注入到$request-attributes里后续控制器用$request-get(agent_id)就能拿到不用再查库。这里有个性能优化点agent.auth中间件默认每次请求都查一次agents表验证代理是否被禁用。我改成先从 Redis 读agent:status:{id}读不到再查库并写缓存TTL 设 300 秒。改完后代理后台的接口平均响应时间从 180ms 降到 45ms。缓存失效逻辑写在代理编辑接口里更新代理状态时主动del掉对应 key。如果你也打算改注意在代理被删除时也要清缓存否则会出现“已删除代理还能登录”的玄学问题。3.2 数据隔离代理只能看到自己分组的数据数据隔离靠的是全局 Scope不是每个查询手动加where。源码在app/Models/Order.php的boot方法里注册了addGlobalScope(agent_group, function($query) { if (app()-has(agent_group_id)) { $query-where(group_id, app(agent_group_id)); } })。agent_group_id是在agent.auth中间件里绑定的绑定后所有 Order 查询自动带上分组条件。这个设计很干净但有个副作用如果你在代理后台写了一个跨分组的统计查询比如“查看所有分组今日订单总额”全局 Scope 会把它限制在当前分组结果永远不对。解决办法是用Order::withoutGlobalScope(agent_group)-where(...)显式去掉 Scope。我踩过一次坑代理后台的订单导出功能用了Order::all()结果导出的 CSV 只有当前分组的数据运营以为数据丢了。后来改成Order::withoutGlobalScope(agent_group)-whereIn(group_id, $allowedGroups)其中$allowedGroups是从代理的group_id向上递归查出的所有子分组 ID。这个递归查询写在AgentService::getAllowedGroups()里用了一个简单的栈实现避免递归深度过大导致栈溢出。3.3 代理等级与佣金结算的配置表代理等级和佣金比例存在agent_levels表里字段包括level、name、commission_rate、min_order_amount。佣金结算逻辑在SettleService::calculate()里公式是commission order_amount * commission_rate但如果order_amount min_order_amount佣金为 0。这个min_order_amount是防止小额订单产生负利润的默认设的是 10 美元。你可以按分组覆盖这个值在groups表里加一个min_order_amount_override字段结算时优先读分组配置。配置表长这样字段名类型默认值说明leveltinyint1代理等级1 最低namevarchar(32)普通代理等级显示名称commission_ratedecimal(5,4)0.0500佣金比例5%min_order_amountdecimal(10,2)10.00最低结算订单金额group_idint0绑定分组0 表示全局改完表结构记得跑php artisan migrate源码里带了 migration 文件在database/migrations/下。如果你用的是生产环境建议先php artisan migrate --pretend看一下 SQL确认没有删列操作再执行。4. 避坑与排查部署这套源码时最容易翻车的五个点4.1 现象订单匹配成功但代理后台看不到原因匹配服务写入的是order:matched:{user_id}但代理后台查询的是orders表。这两个数据源之间有一个异步同步任务SyncMatchedOrders默认每 30 秒跑一次。如果你刚匹配完就去后台看数据还没落库。解决手动执行php artisan order:sync立即同步或者把app/Console/Kernel.php里的调度频率改成everyFiveSeconds()。但注意改太频繁会增加数据库压力我一般设 10 秒。4.2 现象多语言切换后部分菜单还是英文原因菜单项是从数据库menus表读的表里存的是翻译 key 而不是直接文本。如果某个菜单的 key 在目标语言包里不存在__()会回退到en但en里也没有的话就显示 key 本身。解决跑一遍php artisan lang:check --missing它会列出所有在menus表里引用但语言包里缺失的 key。补上对应翻译即可。我习惯在新增菜单时同时往en和zh包里加 key避免上线后才发现。4.3 现象代理登录后提示“无权限访问该分组”原因AgentAuthMiddleware校验的是 JWT 里的group_id和请求参数里的group_id是否一致。如果代理在后台切换了分组但 JWT 没刷新就会 403。解决切换分组后强制刷新 token或者把分组校验改成从数据库实时读取。我选的是前者在切换分组的接口里返回新 token前端替换本地存储。这样不用每次请求都查库性能更好。4.4 现象Redis 连接数暴涨匹配服务变慢原因每个匹配请求都新建一个 Redis 连接没有复用。源码里用的是new \Redis()而不是连接池。解决改用 Laravel 的Redis::connection()门面它底层用了连接池。改完后连接数从 200 降到 20 左右。如果你用的是 Swoole 或 RoadRunner记得在协程里用Redis::connection()的协程安全版本。4.5 现象佣金结算金额和预期不一致原因commission_rate存的是小数但计算时用了intval截断。比如0.055 * 100 5.5intval(5.5)变成 5。解决把intval改成round($commission, 2)保留两位小数。这个 bug 在SettleService第 142 行我改完后对账才平。建议结算前先用测试订单跑一遍确认金额无误再上生产。5. 进阶技巧用自定义 Artisan 命令做语言包完整性校验这套源码的多语言机制很灵活但语言包一多就容易出现 key 缺失或结构不一致。我写了一个lang:check命令放在app/Console/Commands/LangCheck.php核心逻辑是递归对比en目录下所有 JSON 文件的键结构然后检查其他语言包是否完全一致。命令支持--missing参数只输出缺失的 key--fix参数自动从en复制缺失的 key 到目标语言包值留空等翻译填。?php namespace App\Console\Commands; use Illuminate\Console\Command; use Illuminate\Support\Facades\File; class LangCheck extends Command { protected $signature lang:check {--missing : 只显示缺失的 key} {--fix : 自动补全缺失的 key}; protected $description 校验所有语言包与 en 的 key 结构是否一致; public function handle() { $basePath resource_path(lang/en); $baseKeys $this-flattenKeys($basePath); $locales array_diff(scandir(resource_path(lang)), [., .., en]); foreach ($locales as $locale) { $localePath resource_path(lang/{$locale}); if (!is_dir($localePath)) continue; $localeKeys $this-flattenKeys($localePath); $missing array_diff($baseKeys, $localeKeys); if (empty($missing)) { $this-info({$locale}: 完整); continue; } $this-warn({$locale}: 缺失 . count($missing) . 个 key); if ($this-option(missing)) { foreach ($missing as $key) { $this-line( - {$key}); } } if ($this-option(fix)) { foreach ($missing as $key) { $parts explode(., $key); $file array_shift($parts); $this-addKeyToFile($localePath . /{$file}.json, $parts, ); } $this-info({$locale}: 已补全); } } } private function flattenKeys($path, $prefix ) { $keys []; foreach (File::files($path) as $file) { $name pathinfo($file, PATHINFO_FILENAME); $data json_decode(File::get($file), true); $keys array_merge($keys, $this-flattenArray($data, $name)); } return $keys; } private function flattenArray($array, $prefix) { $keys []; foreach ($array as $key $value) { $fullKey $prefix . . . $key; if (is_array($value)) { $keys array_merge($keys, $this-flattenArray($value, $fullKey)); } else { $keys[] $fullKey; } } return $keys; } private function addKeyToFile($file, $parts, $value) { $data File::exists($file) ? json_decode(File::get($file), true) : []; $ref $data; foreach ($parts as $part) { if (!isset($ref[$part])) $ref[$part] []; $ref $ref[$part]; } $ref $value; File::put($file, json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE)); } }这个命令的关键在于flattenKeys方法它把嵌套 JSON 拍平成orders.status.pending这样的点分 key然后做集合差集。--fix参数会按 key 路径逐层创建嵌套结构最后把值设为空字符串。注意addKeyToFile里用了引用赋值$ref这是为了在多层嵌套中动态创建路径。如果你不熟悉 PHP 引用可以改成递归函数但引用写法更简洁。我一般会在 CI 流程里加一步php artisan lang:check --missing如果有缺失就中断构建强制开发者补全翻译。这样上线后就不会出现“菜单显示 key”的尴尬。从那以后我每次新增语言包或改菜单结构都强制走一遍这个命令省了不少事后排查的时间。希望帮到你。本文还有配套的精品资源点击获取