symfony 4 中生成带 _locale 的路由链接需在路由定义中显式声明 _locale 占位符，并在 generate() 或 twig 的 path()/url() 中必须传入 _locale 值，否则报错；默认 locale 配置不影响路由生成，且 requirements 限制需匹配（如仅接受 zh/en）。
Symfony 4 中生成带本地化语言（_locale）参数的路由链接，关键在于路由定义中显式声明 _locale 占位符，并在生成 URL 时传入对应值。系统不会自动补全或推断语言参数，除非你配置了 RequestContext 或设置了默认 locale 并启用 locale 自动切换机制——但生成环节仍需明确提供。
路由必须包含 _locale 占位符
不能只靠翻译组件或请求上下文“隐式”支持。要生成含语言前缀的 URL（如 /en/blog/symfony-url 或 /zh/blog/symfony-url），路由路径本身就得定义 _locale：
- 用注解方式（推荐）：
namespace App\Controller;
use Symfony\Component\Routing\Attribute\Route;
class BlogController extends AbstractController
{
#[Route('/{_locale}/blog/{slug}', name: 'blog_show', requirements: ['_locale' => '[a-z]{2}'])]
public function show(string $locale, string $slug): Response
{
// ...
}
}
- 或 YAML（
config/routes.yaml）：
blog_show:
path: /{_locale}/blog/{slug}
controller: App\Controller\BlogController::show
requirements:
_locale: '[a-z]{2}'
slug: '[a-z-]+'
控制器中生成带 locale 的 URL
调用 UrlGeneratorInterface::generate() 时，必须传入 _locale 参数，否则会报错 “Some mandatory parameters are missing”：
- 生成相对路径：
$url = $generator->generate('blog_show', ['_locale' => 'zh', 'slug' => 'symfony-url']);→/zh/blog/symfony-url - 生成绝对 URL：
$url = $generator->generate('blog_show', ['_locale' => 'en', 'slug' => 'symfony-url'], UrlGeneratorInterface::ABSOLUTE_URL);→https://example.com/en/blog/symfony-url
Twig 模板中使用 path() 或 url()
同样必须显式传入 _locale，不能省略：
-
{{ path('blog_show', {_locale: 'zh', slug: 'symfony-url'}) }}→/zh/blog/symfony-url -
{{ url('blog_show', {_locale: 'en', slug: 'symfony-url'}) }}→https://example.com/en/blog/symfony-url
若想在模板中复用当前请求的语言（比如从 URL 或 session 获取），可先在控制器中把 _locale 注入到模板变量，再传过去；或使用 Twig 全局变量 app.request.attributes.get('_locale') ——但注意：该值仅在当前请求已成功匹配含 _locale 的路由时才存在。
避免常见陷阱
- 不要依赖
default_locale配置来“兜底”生成_locale：它只影响翻译、日期格式等，不影响路由生成逻辑 - 如果路由定义了
requirements（如_locale: '[a-z]{2}'），传入'zh-CN'会失败；应统一用短 locale 标识（zh,en,fr） - 多个 locale 路由共存时，确保所有相关路由（如首页、分类页、分页）都一致包含
_locale占位符，否则跳转会丢失语言上下文
