更新XLF翻译文件后Twig模板中含变量的翻译失效，如何排查解决？

咱们一步步拆解你遇到的问题，核心是翻译更新命令的使用逻辑和翻译文件的匹配问题：

1. 核心诱因：--force参数覆盖了你的翻译内容 #

你执行的bin/console translation:update --force fr命令里，--force是个需要谨慎使用的参数——它会强制覆盖所有已有的翻译单元，不管你之前有没有填写过目标语言的翻译。从你提供的.xlf文件能看到，<target>和<source>内容完全一致，说明命令直接把原本的法语翻译给冲掉了，导致Symfony找不到对应的翻译内容，只能回退显示原始字符串。

修复方式： #

• 如果你想保留现有翻译，仅新增未翻译的条目时，去掉--force参数，执行：

  bin/console translation:update fr
  

  这个命令只会添加新的待翻译单元，不会改动已有的翻译内容。
• 手动修正你的.xlf文件，把<target>替换成正确的法语翻译，比如：

  <trans-unit id="XrWqVVg" resname="Click this %link% for more info.">
    <source>Click this %link% for more info.</source>
    <target>Cliquez sur ce %link% pour plus d'informations.</target>
  </trans-unit>
  

2. 验证Twig模板代码的正确性 #

你的原Twig代码逻辑是没问题的，但要确认两个细节：

• 确保'link'|trans对应的法语翻译存在于你的翻译文件中，不然链接文本会显示原始的"link"。
• |raw过滤器的位置是正确的，它能确保生成的HTML链接不会被转义。再核对下代码有没有拼写错误：

  {{ 'Click this %link% for more info.'|trans({'%link%': '<a href="#">' ~ 'link'|trans ~ '</a>'})|raw }}
  

3. 清除缓存，让翻译生效 #

Symfony会缓存翻译内容，更新翻译文件后一定要清除缓存，尤其是生产环境：

bin/console cache:clear

4. 确保翻译单元的匹配一致性 #

要保证.xlf文件里的resname和你模板中的原始字符串完全一致——包括空格、标点符号，哪怕差一个空格，翻译系统都匹配不上。你当前的resname是正确的，但如果后续修改了模板里的字符串，记得同步更新翻译文件的<source>和resname。

内容的提问来源于stack exchange，提问作者Jonas de Herdt