Symfony 4 需显式配置本地化语言，仅设 APP_LOCALE 环境变量无效；必须启用 Translation 组件、配置 default_locale、提供翻译文件，并在运行时通过 RequestStack 等动态切换 locale。
Symfony 4 默认不自动设置本地化语言，语言偏好需显式配置，环境变量只是其中一种可控的传递方式，不能替代实际的语言加载和切换逻辑。
环境变量可存语言标识，但不等于生效
Symfony 本身不把 APP_LOCALE 或类似变量直接当作运行时语言。它只是一个字符串值，需要在代码中主动读取并应用。常见做法是在 .env 中定义：
APP_LOCALE=zh_CN
然后在服务配置、控制器或 Twig 模板中通过 %env(APP_LOCALE)% 或 $_ENV['APP_LOCALE'] 获取，再传给翻译组件或 locale 切换器。
翻译组件需配合 locale 配置才起作用
仅设环境变量不会触发多语言切换。必须启用 Symfony Translation 组件，并确保：
- 已安装并启用了
symfony/translation -
config/packages/translation.yaml中启用了 fallbacks 和 default_locale（如default_locale: '%env(APP_LOCALE)%'） - 翻译资源文件（如
translations/messages+intl-icu.zh_CN.xlf）已存在且格式正确 - 请求上下文（如路由参数、session、cookie 或 Accept-Language 头）能被识别并覆盖默认 locale
推荐的本地化启动流程
让 APP_LOCALE 真正影响行为，建议按顺序处理：
- 在 .env 设置初始值：
APP_LOCALE=en - 在
config/services.yaml中声明参数：app.locale: '%env(APP_LOCALE)%' - 在
config/packages/framework.yaml中绑定：default_locale: '%app.locale%' - 使用
RequestStack或LocaleSwitcher在运行时动态切换，例如根据 URL 前缀/zh/xxx覆盖当前 locale - 避免硬编码 locale 字符串，全部走参数注入或环境变量解析，便于部署时统一调整
注意常见失效点
即使配置看起来完整，以下情况仍会导致语言不切换：
- 缓存未清除：修改 .env 后必须运行
php bin/console cache:clear --env=prod - 开发环境未启用 debug 模式，导致 locale 覆盖逻辑被跳过
- Twig 模板中未用
{{ 'hello'|trans }}而是直接写死字符串 - 前端 JS 渲染内容未接入 translation API，造成前后端语言不一致
