app::setlocale() 必须在请求早期调用，否则视图中 __() 和 @lang() 会读取旧语言环境；语言文件目录需严格遵循 resources/lang/{locale} 格式，json 文件可直放但键名不能含点号；中间件顺序必须在 encryptcookies 之后、addqueuedcookiestoresponse 之前，且 cli 命令需清除 config:cache 才生效。
App::setLocale() 必须在请求早期调用，否则视图中 __() 和 @lang() 会读取旧语言环境——这是最常被忽略的执行时机问题。
语言文件目录结构必须严格遵循 resources/lang/{locale} 格式
Laravel 的翻译加载器只扫描 resources/lang 下以语言代码命名的子目录（如 en、zh_CN、zh-Hans），不支持任意路径或嵌套层级。
- ✅ 正确：
resources/lang/zh/messages.php、resources/lang/en/auth.php、resources/lang/es.json - ❌ 错误：
resources/lang/zh-CN/messages.php（若未在配置中启用 BCP 47 解析）、lang/zh/messages.php（默认不识别）、resources/lang/zh_CN/messages/strings.php（不递归子目录） - 注意：语言目录名需与
config/app.php中'locale'值完全匹配（大小写敏感），zh-cn和zh_CN被视为不同语言 - JSON 文件可直接放在语言目录下，无需
return语句，但键名不能含点号（.），否则__('auth.failed')无法命中{"auth.failed": "..."}
中间件里设语言时，顺序和位置决定成败
语言切换中间件必须在 EncryptCookies 之后、AddQueuedCookiesToResponse 之前注册，且不能晚于任何可能触发翻译逻辑的中间件（比如日志、验证、异常处理）。
- 在
app/Http/Kernel.php的$middlewareGroups['web']中检查顺序 - 若使用 session 或 cookie 读取语言偏好，确保该中间件在
StartSession之后 - 避免在中间件中调用
trans()或渲染视图——此时语言尚未生效，会回退到默认 locale - URL 前缀方式（如
/zh/login）需配合路由参数绑定：Route::prefix('{locale}')->where('locale', 'zh|en|ja')，并在中间件中用$request->route()->setParameter('locale', $locale)显式透传
CLI 命令里翻译不生效？别只改 .env
Artisan 命令默认绕过 web 中间件栈，APP_LOCALE 环境变量虽能生效，但若已运行过 config:cache，则必须先执行 config:clear，否则缓存中的 config/app.php 仍读取旧值。
- 临时调试：直接运行
APP_LOCALE=zh php artisan tinker，再输入__('welcome')验证 - 自定义命令中动态设语言，应在
handle()开头立即调用app()->setLocale($this->option('locale') ?? 'zh') - 添加
--locale参数时，务必校验该语言目录真实存在：is_dir(resource_path("lang/{$locale}"))，避免静默失败 - 验证规则错误消息（如
required）依赖resources/lang/{locale}/validation.php，缺文件会导致整个验证提示变成键名（如 "validation.required"）
__() 返回原始键或 fallback 内容——这不是翻译没写，而是根本没切进去。
