Symfony 4 翻译优先级冲突源于同名文件共存时仅加载首个匹配项：优先级为 translations/ > Bundle 内 translations/ > 旧式 Resources/translations/；需手动删、移或重命名重复文件，并确保 domain 和 locale 命名严格一致。
Symfony 4 的本地化翻译优先级冲突，本质是多个同名翻译文件（相同 domain + locale + loader）共存时，框架无法确定该加载哪一个。它不报错，但可能静默使用了错误的文件，导致翻译不生效或显示异常内容。
翻译文件加载路径优先级必须明确
Symfony 按固定顺序查找翻译文件，**第一个匹配到的即被采用**，后续同名文件会被忽略。三个位置按从高到低排序：
-
项目根目录下的
translations/（最高优先级，推荐放项目级通用翻译） -
Bundle 内的
src/Resources/{BundleName}/translations/（仅当启用 Bundle 且路径存在时才检查） -
旧式路径
Resources/translations/（已弃用，不建议使用）
若你在 translations/ 和 src/Resources/AppBundle/translations/ 下都放了 messages.zh.yaml，Symfony 只会加载前者，后者完全不会被读取——这不是 bug，是设计行为。
同名文件冲突：删、移、重命名三选一
当 Git 合并或协作中意外出现两个同名翻译文件（如 messages.zh.xlf 在 translations/ 下重复），需人工干预：
- 打开两个文件，逐条比对
<trans-unit id="xxx">或 YAML 键值，确认是否内容一致； - 若完全重复，直接删除一个；
- 若内容不同（比如一个含登录提示、另一个含支付文案），不要合并，而是将缺失条目手动补入主文件（
translations/messages.zh.xlf），再删掉备用文件； - 切勿保留两个同名文件在同一优先级目录下——Symfony 不会合并它们，只会取第一个。
domain 或 locale 拼写不一致导致“看似冲突”
常见误操作：把 zh_CN 和 zh-cn 当作同一语言环境，或混用 messages 与 validators 域。Symfony 区分大小写和连字符格式：
-
messages.zh_CN.xlf和messages.zh-cn.xlf是两个独立文件，需分别维护； - 确保
framework.default_locale配置（如zh_CN）与文件名中的 locale 完全一致； - 调用
$translator->trans('key', [], 'messages')时第三个参数 domain 必须与文件前缀匹配。
验证当前生效的是哪个文件
运行以下命令可查看 Symfony 实际加载了哪些翻译资源：
php bin/console debug:translation zh --domain=messages
输出中会列出所有被扫描到的文件路径。如果某文件没出现在列表里，说明它不在有效路径中，或命名不符合 domain.locale.loader 格式（例如漏了 .xlf 后缀，或 locale 写成 zhCH 这类非法值）。
