\_L() 需自行定义于 app/Helpers.php 并在 composer.json 中注册；其内部须调用 \_\_() 或 trans()，不可硬编码逻辑或切换 locale；\_\_('auth.failed') 返回 key 是因语言包路径错误或 locale 不匹配；Laravel 9+ 废弃 trans\_choice()，改用 \_\_() 配合 ICU 复数语法；Blade 中应统一用点号命名空间如 \_\_('auth.login')；locale 一致性需从路由、中间件、session 全链路控制。
怎么在 Laravel 里正确调用 _L 辅助函数？
直接调用 _L('key') 会报错：「Call to undefined function _L()」——因为 Laravel 默认不提供这个函数，它是社区常见但非官方的封装。你得自己定义，且必须确保它在所有请求上下文中都可用。
- 把函数定义写在
app/Helpers.php（需在composer.json的"autoload": {"files": ["app/Helpers.php"]}中注册） - 函数体内必须用
__()或trans()做底层调用，不能硬编码语言逻辑 - 别在
Helper.php里做 locale 切换（如App::setLocale()），这会污染请求生命周期，应交由中间件或路由参数控制
为什么 __('auth.failed') 有时返回 key 而不是翻译文本？
这不是函数问题，是语言包没加载或路径不对。Laravel 只自动加载 resources/lang/{locale}/{file}.php 下的数组，且要求键名完全匹配。
- 确认当前 locale 已通过
App::getLocale()输出验证，不是en却去查zh_CN目录 - 检查文件路径是否多了一层子目录，比如误建为
resources/lang/zh_CN/auth/login.php，而 Laravel 只认resources/lang/zh_CN/auth.php - 运行
php artisan config:clear，避免缓存了旧的 lang 文件结构
trans_choice() 在 Laravel 9+ 还能用吗？
不能。Laravel 9 移除了 trans_choice()，改用 __() + 复数语法（ICU MessageFormat），否则会抛出 BadMethodCallException。
- 旧写法
trans_choice('messages.apples', $count)必须改为__('messages.apples', ['count' => $count]) - 对应语言包内容也要改：从
return ['apples' => '{0} no apples|{1} one apple|[2,*] :count apples'];改成return ['apples' => 'There {count, plural, =0{are no apples} =1{is one apple} other{are :count apples}}']; - 注意 ICU 语法对空格和标点敏感，少一个空格就可能 fallback 到 key
如何让 Blade 模板里的 {{ __('xxx') }} 自动带命名空间前缀？
不用手动拼 'auth.login'，可以用 PHP 的 __DIR__ 动态推导，但更稳的方式是约定目录即命名空间。
立即学习“PHP免费学习笔记（深入）”；
- 把
resources/lang/en/auth.php的顶层键设为return ['login' => 'Log in', 'failed' => 'Invalid credentials']，然后统一用__('auth.login') - 避免在模板里写
__('login')这种无上下文的 key，容易和其他模块冲突 - 如果项目用了多级子目录（如
resources/lang/en/auth/login.php），Laravel 不识别，必须扁平化到auth.php再用点号访问
