$translator->trans('key')总返回原字符串是因为Translator未加载任何翻译资源，Symfony 7的Translator是“空壳”，必须显式调用addLoader()和addResource()注册loader与资源，且locale、domain、文件路径、依赖包（如symfony/yaml）均需正确配置，否则静默失败。
Translator 默认不自动加载翻译文件，必须显式注册 loader 和 resource 才能生效。
为什么 $translator->trans('key') 总返回原字符串？
这是最常见问题：调用 trans() 后没变化，直接输出了源文本。根本原因不是配置错，而是翻译资源压根没加载进来。
Symfony 7 的 Translator 是“空壳”，不带任何预设 loader 或 resource。即使你放好了 translations/messages.fr.yaml，若没调用 addLoader() 和 addResource()，它就完全看不见。
- 检查是否漏掉
$translator->addLoader('yaml', new YamlFileLoader()) - 确认
addResource()的第三个参数（locale）和你要查的语言一致，比如查法语却传了'en'，必然失败 -
YamlFileLoader需要symfony/yaml包，仅装symfony/translation不够，会静默失败（无异常，但 loader 不工作） - 文件路径必须真实存在且可读；相对路径容易出错，建议用
__DIR__ . '/translations/...'显式拼接
messages.en.yaml 和 admin.fr.xlf 域名怎么区分使用？
域名（domain）是逻辑分组，不是文件名前缀。文件名中的 messages 或 admin 只是约定，真正起作用的是 addResource() 的第四个参数（domain），默认是 'messages'。
比如你有 translations/admin.fr.xlf，加载时必须写：
$translator->addResource('xlf', __DIR__.'/translations/admin.fr.xlf', 'fr', 'admin');
否则它会被归入默认 messages 域，$translator->trans('key', domain: 'admin') 就查不到。
- 多个 domain 可共存，互不影响；适合按模块拆分翻译（如
user、payment） - 模板里用
{{ 'key'|trans(domain: 'admin') }}显式指定，不指定则走默认messages - 同一 locale + 同一 key + 不同 domain = 不同翻译值，可用于上下文歧义消解（例如 “run” 在 admin 域译作 “执行”，在 help 域译作 “运行”）
复数规则失效？%count% 替换后数字没变？
Symfony 7 的复数处理依赖 ICU 格式字符串，不是简单拼接。直接写 '%count% item' 永远不会触发复数逻辑。
正确写法必须用 ICU message format，例如：
'item_count' => '{count, plural, =0 {No items} =1 {One item} other {# items}}'
然后调用：
$translator->trans('item_count', ['%count%' => 2])
注意：占位符名必须和 ICU 中的变量名一致（这里是 count，不是 count%），且 % 符号只在占位符名中出现一次，ICU 内部不用 %。
- 不支持旧式 PHP 数组语法（如
['one' => '...', 'other' => '...']） - ICU 规则严格区分 =0、=1、other，不能写成
zero或one（那是 gettext 风格） - 如果 locale 对应的 translation 文件里没提供 ICU 字符串，fallback 会退到单数形式，看起来像“没生效”
开发时改了 YAML 翻译文件，为什么页面没更新？
Symfony 7 默认启用翻译缓存（尤其在 prod 环境），修改文件后不重启服务或清缓存，新内容不会加载。
开发阶段建议关掉缓存或强制刷新：
- 运行
php bin/console cache:clear清除全部缓存（包括 translation 缓存） - 或临时禁用缓存：在
config/packages/translation.yaml加enabled: false（仅限 dev） - 若用自定义 loader 从数据库加载，缓存行为取决于你是否实现了
CacheableLoaderInterface；没实现就每次重读，实现了就得手动清缓存 - 注意：.yaml 文件语法错误（如缩进错、冒号后少空格）会导致整个 domain 加载失败，且无明确报错，表现为“该语言下所有翻译消失”
关键点在于：Symfony 7 的翻译系统高度解耦，loader、resource、domain、locale、cache 全部需要显式连接，任何一个环节断开，都会导致静默失败——而不是抛异常。最容易被忽略的是 loader 依赖包缺失和 YAML 语法隐性错误。
