必须显式配置translation.yaml中framework.translator.default_path为'%kernel.project_dir%/translations'并确保目录存在、命名规范（如messages.en.xlf），同时在twig.yaml中注入translator服务，才能使{{ 'app.welcome'|trans }}正常输出译文而非键名。
Symfony 4 中并没有一个叫“本地化翻译调试模式”的独立开关，但你实际遇到的，很可能是以下几种开发环境下的翻译行为表现，常被误认为是“调试模式”：
- 翻译键（如
app.welcome）直接显示在页面上，而不是对应译文 - Twig 模板中
{{ 'app.welcome'|trans }}输出原文而非翻译 - 控制台提示
Translation key not found或MissingResourceException - 开发时看到带括号的占位符，比如
(app.welcome)
这些现象不是因为开启了某种调试开关，而是翻译组件未正确加载资源或配置缺失。所谓“关闭调试模式”，本质是让翻译正常工作、不暴露键名。
✅ 确保翻译资源被正确加载
Symfony 4 默认不会自动扫描 translations/ 目录，必须显式配置路径：
# config/packages/translation.yaml
framework:
default_locale: 'en'
translator:
default_path: '%kernel.project_dir%/translations'
fallbacks: ['en']
⚠️ 注意：
-
default_path必须存在且可读（目录名必须是translations/，不是translation/或i18n/） - 文件命名要规范：
messages.en.xlf、messages.fr.xlf（推荐 XLIFF），不能是messages.en.yaml（除非你额外启用了 YAML 加载器）
✅ 检查翻译文件格式和内容
确保 translations/messages.en.xlf 结构合法（XLIFF 1.2）：
<?xml version="1.0"?><xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2"><file source-language="en" datatype="plaintext" original="file.ext"><trans-unit id="app.welcome"><source>app.welcome</source><target>Welcome!</target></trans-unit></file></xliff>
✅ source-language 值需与文件后缀一致（en.xlf → source-language="en"）
❌ 不要漏掉 和 <trans-unit></trans-unit> 包裹，否则 Symfony 会静默跳过该文件
✅ Twig 中正确使用 trans 过滤器
Symfony 4.3+ 默认禁用全局 trans 函数，需手动注入 translator：
# config/packages/twig.yaml
twig:
globals:
translator: '@translator'
之后模板才能写：
{{ 'app.welcome'|trans }}
更稳妥的方式（推荐）是在控制器中传入 locale：
return $this->render('page.html.twig', [
'message' => $translator->trans('app.welcome', [], 'messages', 'fr'),
]);
✅ 验证当前 locale 是否生效
翻译不生效，90% 是 locale 没设对。检查：
- 请求 URL 或 session 中是否设置了
_locale参数 - 路由是否支持 locale（如
/{_locale}/home+defaults: { _locale: '%kernel.default_locale%' }） - 执行
$translator->getLocale()看输出是否是你期望的语言（如fr），不是则说明 locale 未被 Translator 感知到
不复杂但容易忽略
