✅ 正确命令是 composer require laravel-lang/lang，但需按 laravel 版本选择分支：laravel 10+ 用 v13.x，9 用 v12.x，8 用 v11.x；安装后需手动执行 php artisan lang:publish zh_cn 发布语言文件，并注意清缓存。
composer require laravel-lang/lang 安装失败？先确认 Laravel 版本匹配
直接运行 composer require laravel-lang/lang 很可能报错，因为 laravel-lang/lang 已停止维护，当前主流用的是 laravel-lang/lang 的继任者 —— laravel-lang/lang 项目已归档，实际应使用 laravel-lang/lang 的新组织地址：laravel-lang/lang 并不存在，正确包名是 laravel-lang/lang（注意：这是常见混淆点）。真实可用的包是：laravel-lang/lang 已废弃，目前推荐的是 laravel-lang/lang 的镜像维护版 —— 实际上，**官方推荐且持续更新的是 laravel-lang/lang 这个包**，但它在 Packagist 上的正式名称是：laravel-lang/lang。等等，别绕晕——结论很直接：
- ✅ 正确命令是：
composer require laravel-lang/lang - ⚠️ 但必须先查清你用的 Laravel 版本，因为不同版本对应不同分支：
– Laravel 10+ → 用v13.x分支（默认安装）
– Laravel 9 → 推荐v12.x
– Laravel 8 → 用v11.x
– 更早版本需手动指定旧 tag，例如composer require laravel-lang/lang:10.11.0 - ❌ 不要尝试
composer require caouecs/laravel-lang（原作者已弃更，Laravel 9+ 兼容性差，翻译文件缺失或过时）
安装后语言文件没出现在 resources/lang？检查是否启用了自动发布
Laravel 9.2+ 默认启用 package discovery，laravel-lang/lang 会自动注册 LangServiceProvider 并尝试发布语言文件。但很多情况它静默失败，resources/lang 下空空如也。原因通常是：
- 你的 Laravel 版本低于 9.2，未启用自动发现（
extra.laravel.dont-discover被设为 true） -
LangServiceProvider没被正确加载（检查config/app.php中providers是否含LaravelLang\LangServiceProvider::class） - 你跳过了发布步骤 —— 它不会自动把文件写入
resources/lang，必须手动执行
解决办法只有一条路：
php artisan lang:publish zh_CN
其中 zh_CN 是你要的语言代码（支持 en, zh_CN, ja, fr, de 等 100+ 种）。该命令会把对应语言的 auth.php、pagination.php、passwords.php、validation.php 等文件复制到 resources/lang/zh_CN/ 目录下。
如果提示 Command "lang:publish" is not defined，说明服务提供者没加载成功，退回上一步检查 composer dump-autoload 和配置文件。
切换语言不生效？别只改 config/app.php 的 locale
改了 config/app.php 里的 'locale' => 'zh_CN'，但页面还是英文？问题往往出在三处：
- Laravel 的语言加载顺序：请求头
Accept-Language> session > cookie > config/app.php → 如果浏览器发来en-US，它会优先用英文 -
多语言路由未适配：如果你用
Route::prefix('{locale}')，但中间件没设置App::setLocale($request->locale)，则__()函数仍读默认语言 - 缓存干扰：运行过
php artisan config:cache后，修改config/app.php不生效，必须重缓存或临时禁用
快速验证是否加载成功：在 Blade 模板里写 {{ app()->getLocale() }}，看输出是否为你设的值；再试 {{ __('validation.required') }}，看是否返回中文“此字段是必填项”。
自定义翻译覆盖 vendor 文件？别动 vendor，用本地覆盖机制
想改某个翻译文案（比如把“The :attribute must be at least :length characters.”改成更口语化的中文），**绝对不要直接编辑 vendor/laravel-lang/lang/zh_CN/validation.php** —— Composer 更新后全丢。
正确做法是利用 Laravel 的语言覆盖规则：
- 在
resources/lang/zh_CN/validation.php中只写你想改的键，其余留空 - Laravel 会自动合并：先载入 vendor 中的完整文件，再用
resources/lang/zh_CN/下同名文件里的键覆盖 - 例如只需覆盖一条：
return [ 'required' => '这个字段不能空哦！', ];
这个机制对所有语言文件都有效（auth.php, passwords.php），也是唯一安全的定制方式。
真正容易被忽略的是：Laravel 会缓存语言文件（尤其在 production 环境），改完后记得清缓存：php artisan view:clear 和 php artisan config:clear 不够，得加 php artisan lang:clear（如果装了 laravel-lang/lang）或手动删 storage/framework/cache/data/ 下相关缓存项。
