Symfony多语言路由需显式定义{_locale}参数并手动传入，Web请求靠URL解析locale，CLI命令必须显式传递\_locale参数生成URL，推荐用参数化配置管理支持语言。
Symfony 多语言路由不是靠“自动切换”实现的，核心在于把 _locale 当作一个显式路由参数来设计和使用。Web 请求能“感知语言”，是因为请求对象带 locale；CLI 命令没有请求上下文，所以必须手动传入 _locale —— 这一点决定了整个本地化方案的设计逻辑。
1. 路由定义必须支持 _locale 参数
所有需要本地化的路由，路径必须声明 {_locale} 占位符，并通过 requirements 限定合法值：
- 注解写法示例：
#[Route("/{_locale}/about", defaults: ["_locale" => "en"], requirements: ["_locale" => "en|fr|es|de"])] - YAML 写法示例：
app_about:<br> path: /{_locale}/about<br> defaults: { _controller: App\Controller\AboutController::index, _locale: en }<br> requirements: { _locale: en|fr|es|de } - 验证是否生效：运行
bin/console debug:router app_about，应看到多条 pattern（如/en/about、/fr/a-propos），说明路由已按 locale 解析。
2. 控制器中接收并传递 locale
控制器方法需显式声明 string $locale 参数，且该参数会自动从 URL 中提取：
- 方法签名示例：
public function index(string $locale): Response - 若需在模板中生成其他语言链接，不要依赖当前请求 locale，而应明确构造：
$this->generateUrl('app_about', ['_locale' => 'fr']) - 避免在控制器里调用
$request->setLocale()后再生成 URL——它对后续generate()无效，因为 UrlGenerator 不读取 Request 的 locale，只认路由参数或默认 locale 配置。
3. CLI 命令中生成本地化 URL 的唯一正确方式
命令行无 HTTP 上下文，setLocale()、RequestStack、修改 kernel.default_locale 全部无效：
- ✅ 正确做法：调用
urlGenerator->generate()时，**必须显式传入['_locale' => 'fr']**：$url = $this->urlGenerator->generate('app_contact', ['_locale' => 'fr']); - ⚠️ 错误尝试：
–$this->urlGenerator->setLocale('fr')（UrlGenerator 没有这个方法）
–$container->setParameter('kernel.default_locale', 'fr')（容器参数不可运行时修改）
– 手动 new Request() 并 push 到 RequestStack（UrlGenerator 不从中读取 locale）
4. 可选但推荐：参数化语言配置提升可维护性
避免在每个路由里硬编码 en|fr|es|de，改用参数统一管理：
- 在
config/services.yaml中定义：parameters:<br> app_locales: 'en|fr|es|de'<br> app_default_locale: 'en'
- 在 YAML 路由中引用：
requirements: { _locale: '%app_locales%' }<br>defaults: { _locale: '%app_default_locale%' } - 这样增删语言只需改参数，无需逐个调整路由文件，也便于环境变量覆盖（如 staging 环境只启用 en+fr）。
