不能靠composer require一键装好中文语言包并自动生效；必须手动匹配Laravel版本分支，将vendor/laravel-lang/lang/zh_CN复制到resources/lang/zh_CN，再清缓存，否则__('login')永远返回英文。
不能靠 composer require 一键装好中文语言包并自动生效——Composer 本身不提供语言包，只管装库；所谓“多版本中文包”，本质是多个不同框架/版本适配的翻译文件集合，必须手动匹配、复制、清缓存，否则 $translator->trans('login') 永远返回英文原文。
laravel-lang/lang 怎么选对分支并复制到正确路径
这个包只是语言文件仓库，不是运行时组件。装完不会自动加载，必须人工介入：
- 先确认你用的 Laravel 版本：运行
php artisan --version，比如输出Laravel Framework 11.12.0，就对应v11.x分支 - 执行
composer require laravel-lang/lang --dev后，文件实际在vendor/laravel-lang/lang/zh_CN/，而 Laravel 只读resources/lang/zh_CN/ - 必须手动复制：
cp -r vendor/laravel-lang/lang/zh_CN resources/lang/（注意路径大小写，zh_CN≠zh-cn） - 复制后立刻清缓存：
php artisan lang:clear或删掉storage/framework/cache/data/下相关键
symfony/translation 加载中文 YAML 文件总失败？三处硬伤要修
装了 symfony/translation 和 symfony/yaml 还是返回原文，大概率卡在这三个地方：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
addResource()第二个参数必须是绝对路径：用__DIR__ . '/translations/messages.zh_CN.yaml'，别用相对路径./translations/...，CLI 和 Web 环境下解析结果不同 - 第四个参数（domain）必须和
trans()调用时一致：比如$translator->trans('login', [], 'messages')，那addResource()的 domain 就得是'messages'，写成'translations'就查不到 - YAML 格式依赖
symfony/yaml，但symfony/translation默认不带它——必须单独执行composer require symfony/yaml，否则解析器直接报错或静默跳过
多语言包共存时怎么避免冲突和覆盖
项目里既有 Laravel 自带的 resources/lang，又想加第三方 vendor/xxx/i18n/zh，不能简单堆叠：
- Laravel 不会自动扫描 vendor 目录下的语言文件，必须显式注册：在
config/app.php的'locale'下方加'fallback_locale' => 'en'，再在服务提供者里调用Lang::addNamespace('vendor', __DIR__.'/../vendor/xxx/i18n') - 如果两个包都提供
validation.php，Laravel 会按注册顺序覆盖——后注册的赢，但 key 冲突时前一个就失效 - 避免用相同 domain 名：比如都叫
messages，改成vendor::messages或admin::messages，调用时写__('welcome', [], 'vendor') - 别把不同框架的语言包混放：Laravel 的
zh_CN目录结构（auth.php,pagination.php）和 Symfony 的messages.zh_CN.yaml完全不兼容，强行合并会导致部分文件被忽略
最易被忽略的是路径大小写和 domain 绑定——zh_CN 和 zh-cn 在 Linux 下是两个目录，trans('key', [], 'admin') 如果没调用 addResource(..., 'admin')，哪怕文件存在也查不到。迁移时别只盯着“装没装”，得验证每一条 trans() 调用是否真走到了目标文件。
