Laravel多语言生效需显式设置locale并确保其在请求早期持久化，翻译文件须按resources/lang//.php规范命名，动态切换应通过中间件校验并存入session，验证器需手动setLocale，Blade中__()失效常因中间件未覆盖、缓存未清除或服务提供者中过早调用。

Laravel 的多语言本地化不是靠“装个包”或“改个配置”就自动生效的，核心在于 locale 的实际读取时机、翻译文件加载路径是否匹配、以及视图/验证器等组件是否真正使用了当前 locale —— 很多时候你明明调用了 App::setLocale('zh_CN')，但 __('Welcome') 还是返回英文，问题往往出在请求生命周期中 locale 被重置或未被持久化。

怎么确认当前生效的 locale 是什么

Laravel 不会自动从浏览器 Accept-Language 头或 URL 参数推断并设置 locale，必须显式调用 App::setLocale() 或通过中间件设置。最直接的验证方式是在任意路由中打印：

dd(App::currentLocale(), config('app.locale'));

App::currentLocale() 返回运行时当前生效的 locale（可被动态修改），config('app.locale') 是配置文件里写死的默认值，二者不一致很常见。如果你没手动设过，它永远等于配置里的 app.locale，哪怕 URL 带了 ?lang=ja 也无效。

语言包文件放哪、命名怎么写才被识别

Laravel 只认固定结构的目录和文件名：resources/lang//.php，其中 必须是 IETF 语言标签格式（如 en、zh_CN、pt_BR），不能是 zh-cn 或 Chinese； 默认是 messages.php，也可自定义（如 validation.php）。

• resources/lang/en/messages.php → 会被 __('key') 或 trans('key') 加载
• resources/lang/zh_CN/messages.php → 必须是下划线，不能用短横线
• resources/lang/zh_CN/auth.php → 需用 __('auth.key') 显式指定文件名

常见错误：把文件放在 lang/zh-cn/ 下，或命名为 zh_cn.php —— Laravel 直接跳过，回退到 config('app.locale') 对应的语言包。

如何安全地动态切换 locale（比如通过 URL 参数或 Session）

不能只在某个控制器里调用 App::setLocale()，因为下一次请求又会重置。必须在请求早期（如中间件）完成设置，并确保后续所有翻译调用都基于这个 locale。推荐做法：

• 写一个 SetLocale 中间件，在 handle() 里读取 $request->input('lang') 或 $request->session()->get('locale')
• 调用 App::setLocale($locale) 前，先用 in_array($locale, config('app.locales', ['en', 'zh_CN'])) 校验合法性
• 把选中的 locale 存入 session（$request->session()->put('locale', $locale)），避免每次都要传参
• 在中间件里加 app()->setLocale($locale)，而非 Config::set('app.locale', $locale) —— 后者只改 config 缓存，不影响 Translator 实例

注意：Laravel 的 Validator 默认使用 app.locale 配置，即使你调用了 App::setLocale()，验证错误消息仍可能不更新。解决办法是在验证前手动设置：$validator->setLocale($locale)。

Blade 模板里 __() 不生效？检查这三点

__('Welcome') 返回空或默认语言，大概率不是翻译文件问题，而是上下文丢失：

• 当前请求没经过设置 locale 的中间件（比如访问的是 API 路由，而中间件只注册在 web 组）
• 你用了 @lang('Welcome')，但它不走 translator，只查 resources/lang//messages.php，且不支持点号语法（@lang('auth.failed') 会报错）
• 缓存了视图（php artisan view:cache）或配置（php artisan config:cache），导致新语言包没加载 —— 开发时关掉缓存，或执行 php artisan view:clear && php artisan config:clear

最隐蔽的坑：你在服务提供者（如 AppServiceProvider）的 boot() 方法里调用了 __('xxx') —— 此时 locale 尚未设置，永远走默认值。