laravel 9 将语言文件目录从 `resources/lang` 迁移至项目根目录 `lang/`，但若旧目录未彻底清除，框架仍会优先加载 `resources/lang`，导致新路径失效。本文详解迁移要点、排查步骤及最佳实践。
在 Laravel 9 中，语言文件目录的位置变更是一项关键升级改动：官方已将默认语言资源路径从 resources/lang/ 移至项目根目录下的 lang/（即与 app/、config/ 同级）。这一调整简化了资源组织结构，也与 storage/、bootstrap/ 等核心目录层级保持一致。然而，该变更并非“自动切换”——Laravel 的翻译加载器（FileLoader）会按预设顺序搜索多个路径，其中 resources/lang 仍被保留在搜索队列中，且具有更高优先级。
这意味着：即使你已将 lang/pt-BR/messages.php 正确放置于项目根目录，并配置了 'locale' => 'pt-BR'，只要 resources/lang/ 目录（哪怕为空）依然存在，Laravel 就会首先尝试从此处加载翻译，而忽略根目录的 lang/。这正是你遇到 Lang::get('messages.welcome') 返回字面键 "messages.welcome"（而非翻译值）的根本原因——框架未找到对应翻译项，于是回退到原始键名。
✅ 正确迁移步骤如下：
-
彻底删除旧目录
执行以下命令（请确认无误后再操作）：rm -rf resources/lang
⚠️ 注意：仅重命名或清空内容无效，FileLoader 会检测目录是否存在。
-
确保新目录结构正确
根目录下应有：your-project/ ├── lang/ │ └── pt-BR/ │ └── messages.php // 返回 ['welcome' => 'Welcome to the app!'] ├── app/ ├── config/ └── ...
-
验证配置与调用
config/app.php 中保持：'locale' => 'pt-BR',
控制器中使用标准语法（无需更改）：
use Illuminate\Support\Facades\Lang; return response()->json([ 'message' => Lang::get('messages.welcome') // ✅ 现在返回 'Welcome to the app!' ]); -
可选：清除配置与视图缓存（升级后推荐执行）
php artisan config:clear php artisan view:clear # 若使用了语言包缓存（如 `php artisan lang:publish`），也需清理
? 快速诊断技巧：
可通过 dd(app('translator')->getLoader()->getPaths()) 查看当前所有加载路径及其顺序。Laravel 9 默认路径顺序为：
[
base_path('lang'), // ← 应该是你的目标路径
resource_path('lang'), // ← 必须不存在，否则优先匹配
]? 总结与建议：
- Laravel 的升级指南强调“移动目录”，但未显式提醒“必须移除旧路径”——这是典型的隐式依赖陷阱；
- 始终检查 resource_path('lang') 是否真实存在（file_exists(resource_path('lang'))），而非仅依赖 IDE 文件树视觉判断；
- 新建 Laravel 9 项目能正常工作，正是因为其初始结构本就不含 resources/lang/；
- 若项目中存在自定义 TranslationServiceProvider 或手动注册 FileLoader，需同步更新路径逻辑。
完成上述清理后，Lang::get()、__() 辅助函数及 Blade 中的 @lang 指令均将无缝支持根目录 lang/ 结构，无需额外配置。
