Symfony多语言路由需显式定义{_locale}占位符，通过prefix/requirements/defaults统一管理，顺序匹配关键，且{_locale}必须手动传入path()生成URL，同时需确保路由locale与Translator同步。
直接说结论：Symfony 多语言路由不是靠“复制多套路由”，而是用 {_locale} 占位符 + defaults + requirements 一套定义覆盖所有语言前缀，关键在路径结构、顺序和 locale 同步机制。
路由定义必须显式包含 {_locale} 占位符
不能指望 Symfony 自动给已有路由加语言前缀。要生成 /en/blog 或 /fr/contact 这类 URL，路由路径本身就得写明 {_locale} —— 它不是可选装饰，是路径的一部分。
- ✅ 正确写法（YAML）：
controllers: resource: ../src/Controller/ type: annotation prefix: '/{_locale}' defaults: { _locale: '%kernel.default_locale%' } requirements: { _locale: 'en|fr|es|de' } - ✅ 注解写法：
/** * @Route("/{_locale}/{slug}", name="post_show", * defaults={"_locale": "en"}, * requirements={"_locale": "en|fr|es|de"}) */ - ❌ 错误写法：只写
@Route("/{slug}")然后幻想path('post_show', ['slug' => 'blog'])能自动补_locale—— 会报错“Some mandatory parameters are missing” - ⚠️ 注意：
requirements中的正则不接受空字符串，所以/blog（无前缀）无法和/{_locale}/{slug}共存于同一条路由；需另配一条不带{_locale}的路由，或统一用可选参数方式（见下条）
首页等“无 slug”路径要用可选 {_locale} 单独处理
/ 和 /fr 都该指向首页，但 /{_locale} 默认要求 _locale 非空，所以不能只靠 requirements 解决。得让 _locale 真正可为空。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- ✅ 推荐方案：拆成两条路由，按顺序匹配
# config/routes.yaml # 匹配 /fr、/es 等带语言前缀的首页 home_with_locale: path: '/{_locale}' controller: App\Controller\HomeController::index requirements: { _locale: 'en|fr|es|de' } <h1>匹配 /（无前缀），设默认 locale</h1><p>home_default: path: '/' controller: App\Controller\HomeController::index defaults: { _locale: '%kernel.default_locale%' } - ⚠️ 陷阱：如果把
/{_locale}放在/{_locale}/{slug}前面，/fr会被当成{slug} = 'fr'匹配到内容页路由 —— 所以顺序很重要，更泛的路径放后面 - ? 补充：若坚持单条路由支持可空
_locale，可用requirements: { _locale: 'en|fr|es|de|' }（末尾加竖线和空），但 Symfony 5.4+ 对空字符串匹配不稳定，不推荐生产环境用
生成带语言的 URL 必须手动传 _locale
path() 和 url() 不会自动读取当前请求的 _locale 去补参数。即使你在 URL 里看到 /fr/about，调用 path('about') 仍会生成 /about，除非你显式传值。
- ✅ Twig 中正确写法：
{{ path('post_show', { _locale: 'fr', slug: 'hello-world' }) }}→ 输出/fr/hello-world - ✅ 控制器中：
$this->generateUrl('post_show', ['_locale' => 'fr', 'slug' => 'hello-world']) - ⚠️ 常见错误：以为设了
defaults: { _locale: 'fr' }就能省略 —— 不行。defaults 只影响**匹配入站请求**，不影响**生成出站链接** - ? 提示：可在 Twig 模板里用
app.request.get('_locale')获取当前语言，但仅限当前请求上下文有效；切换语言时，链接必须重新生成，不能缓存旧 URL
翻译组件和路由 locale 必须联动，否则 trans() 不生效
路由解析出 _locale 后，如果不把它同步给 TranslatorInterface，trans() 依然返回英文原文 —— 因为 translator 还在用默认 locale。
- ✅ 确保
config/packages/framework.yaml启用了 session：framework: session: true（LocaleAwareListener 依赖 session 存储当前 locale） - ✅ 检查
config/routes.yaml是否为路由设置了defaults: { _locale: '%kernel.default_locale%' }，且没被其他配置覆盖 - ✅ 调试方法：在控制器里加
dump($translator->getLocale(), $request->getLocale());
，两个值必须一致才说明联动成功 - ⚠️ 最容易被忽略的一点：如果你用的是自定义中间件（比如从 query 参数取 locale），必须手动调用
$request->setLocale($locale)，否则 Symfony 的 LocaleAwareListener 不会触发
真正麻烦的从来不是怎么写那几行路由配置，而是确保 _locale 从 URL 进来、被路由识别、传给 request、再喂给 translator、最后驱动 trans() 和 path() —— 这条链上任何一环断开，多语言就只剩个空壳。
