Laravel Lang 中库尔德语（ckb）翻译完成度报告：15 个缺失键位全解析与补全指南-开发者社区

后端

【免费下载链接】lang

List of 128 languages for Laravel Framework, Laravel Jetstream, Laravel Fortify, Laravel Breeze, Laravel Cashier, Laravel Nova and Laravel UI.

项目地址：https://gitcode.com/gh_mirrors/la/lang

点击查看免费下载

本指南以docs/statuses/ckb.md状态文档为主线，深入分析 Laravel Lang 仓库中库尔德语（Sorani，语言代码 ckb）本地化包的翻译完成情况：哪些键位尚未翻译、它们分别来自哪个上游组件（Passkeys、Framework、Validation 规则），以及如何借助仓库源码与目录结构快速补全。读完本文，你将掌握该语言包 97% 完成度之下的缺口全貌，并能定位到具体的源码出处与对应的语言文件。

一、ckb 状态文档是什么：Laravel Lang 的逐语言完成度报告

在 docs/status.md 的完成度总览中，128 种语言的整体翻译进度为97.82%（147.1K / 150.4K），其中绝大多数语言（包括 ckb）以 ❗ 标记为"尚未 100% 完成"，仅 ko 标记为 ✔。

docs/statuses/目录下每一种语言对应一份状态页，docs/statuses/ckb.md正是库尔德语（Sorani，ckb）的缺口清单。该文档直接给出三个核心数字：

All missed（总缺失）：15
json 格式缺失：11
php-inline 格式缺失：2
php 格式缺失：2

文档中每个缺失条目以"Key / Value"表格呈现：Key 为源字符串键，Value 为源语言（英文）中的默认值。换句话说，这些键位已经存在于上游英文语言包中，但 ckb 语言文件里尚未提供库尔德语翻译，运行时 Laravel 会回退显示英文原文。

二、ckb 语言包的文件结构：缺失键散落在哪些文件里

仓库中 ckb 的翻译文件位于 locales/ckb/ 目录，共 5 个 JSON 文件：

文件	对应 Laravel 消费格式	缺失数
`json.json`	`lang/ckb.json`（通用 JSON 键值对，供前端/资源使用）	11
`php.json`	`lang/ckb/*.php`（含`:attribute`占位符的完整校验消息）	2
`php-inline.json`	`lang/ckb/*.php`的 inline 变体（"This field..." 形式）	2
`json-inline.json`	通用 JSON 的 inline 变体	0（已完整）
`_excludes.json`	被排除、无需翻译的键清单（如 "CSV (.csv)"、"Excel (.xlsx)"）	—

从状态文档可以明确推断：ckb 的 json-inline 格式 100% 完成，缺口全部集中在 json、php、php-inline 三个文件中。补全工作只需聚焦 locales/ckb/json.json、locales/ckb/php.json 与 locales/ckb/php-inline.json。

三、json 格式的 11 个缺失键：来自 Passkeys 与 Framework 加密环境文件

docs/statuses/ckb.md中 json 部分列出的 11 个键，按来源可以清晰地分成两组，均可从仓库源码得到印证。

3.1 Passkeys（通行密钥）模块相关（7 个）

以下键位与 Laravel Passkeys 扩展的通行密钥注册/验证流程直接相关：

Invalid credential format.
Passkey not recognized. It may have been removed from your account.
Passkey registration session expired. Please try again.
Passkey verification session expired. Please try again.
Unable to register passkey. Please try again.
Unable to register this passkey.
Unable to verify passkey. Please try again.

对照源码，其中 3 个来自 source/passkeys/main/passkeys.json（Invalid credential format.、两个 session expired 消息），另外 5 个来自 source/passkeys/extended.json（Passkey not recognized...、Unable to register...、Unable to sign in with this account.等）。Unable to sign in with this account.也属于该扩展的登录失败提示。这些键用于 WebAuthn 通行密钥认证失败、会话过期、凭证格式非法等用户可见的错误提示场景。

3.2 Framework 加密环境文件命令相关（4 个）

另 4 个键来自 Laravel Framework 的加密环境文件（.env加密/解密）相关命令输出：

The existing encrypted environment file is not in readable format. Use --force to overwrite it.
The existing encryption key is required to update the encrypted environment file.
Unable to write the encrypted environment file.
Unable to sign in with this account.（按内容归类见上文）

前三者在 source/framework/13.x/framework.json 中均有对应条目，属于php artisan env:encrypt/env:decrypt系列命令在文件已存在、密钥缺失或写入失败时输出的提示文案。值得注意的是，这类键在source/framework/master/等分支的版本间存在差异，翻译时需要以目标 Laravel 版本的源文件为准。

四、php 与 php-inline 的缺失键：两条校验规则的库尔德语翻译

ckb 在 php 与 php-inline 两种格式中各缺失 2 个键，且二者一一对应，均为 Laravel Validation 规则：

规则键	php 值（含 :attribute）	php-inline 值（无 :attribute）
`array_keys`	`The :attribute field must only contain the following keys: :values.`	`This field must only contain the following keys: :values.`
`base64`	`The :attribute field must be a valid Base64 string.`	`This field must be a valid Base64 string.`

这两个规则定义于 source/framework/master/validation.php：

array_keys：要求被校验字段的键必须限定在:values指定的键集合内；
base64：要求字段值必须是合法的 Base64 字符串。

在 locales/ckb/php.json 与 locales/ckb/php-inline.json 中，这两条目前仍保留英文原文。从搜索确认，ckb 中同族的in_array_keys、required_array_keys等规则键已有库尔德语翻译，因此补全时可以直接参考这些相邻键的翻译风格，例如php.json中in_array_keys译为"مەیدانی :attribute دەبێت لانیکەم یەکێک لەم کلیلانەی خوارەوەی تێدابێت: :values."，保持:attribute与:values占位符不变即可。

五、补全 ckb 缺失翻译的实操路径

基于以上分析，完成 ckb 语言包 100% 覆盖的步骤非常明确：

定位缺口：以 docs/statuses/ckb.md 为权威清单，共 15 个键；
找到对应语言文件：json 组的 11 个键写入 locales/ckb/json.json，php 组的 2 个键写入 locales/ckb/php.json，php-inline 组的 2 个键写入 locales/ckb/php-inline.json；
核对源码默认值：以 source/passkeys/main/passkeys.json、source/passkeys/extended.json、source/framework/13.x/framework.json 与 source/framework/master/validation.php 中的英文原文为翻译基准；
保留占位符：翻译时必须原样保留:attribute、:values等占位符以及--force等命令参数字样，否则运行时消息替换会失效；
提交后复检：翻译提交后，重新生成的状态文档中All missed应为 0，且docs/status.md中 ckb 的标记将从 ❗ 变为 ✔。

六、小结

docs/statuses/ckb.md虽然是一份自动生成的翻译缺口清单，但它精确地揭示了 ckb（库尔德语 Sorani）语言包与 100% 完成度之间的最后距离：15 个键位，集中在 Passkeys 通行密钥错误提示、Framework 加密环境文件命令文案与两条校验规则（array_keys、base64）上。结合source/目录的源码与locales/ckb/的语言文件，任何贡献者都可以在短时间内完成全部补全，让 Laravel Framework、Fortify、Breeze、Jetstream、Nova、Cashier 等组件在库尔德语环境下获得完整的母语体验。