应优先用path()生成相对路径用于页面内跳转，url()生成绝对url用于邮件或api响应；两者均需按路由定义的参数名传值，多语言需显式传入_locale。
直接用 path() 或 url() 函数，别手写 URL —— 否则路由改了模板全崩。
什么时候该用 path()，什么时候用 url()
两者都调用同一个路由生成器，区别只在返回值：path() 返回相对路径（如 /blog/post-123），url() 返回绝对 URL（含协议和域名，如 https://example.com/blog/post-123）。
- 前端页面内跳转、表单
action、AJAX 请求地址 → 优先用path()，更轻量、不依赖当前域名配置 - 邮件模板、API 响应里要发给外部系统的链接、Open Graph 标签 → 必须用
url()，否则缺协议/主机名会 404 - 项目启用了子目录部署（如
https://example.com/myapp/）→path()自动带前缀，url()也正确，不用额外处理
带参数的路由怎么安全传值
控制器里定义的路由参数（比如 @Route("/post/{slug}", name="app_post_show")），必须按名传参，不能靠顺序。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 错误写法：
{{ path('app_post_show', ['post-123']) }}→ Twig 报错Too few arguments - 正确写法：
{{ path('app_post_show', {slug: 'post-123'}) }}→ 键名slug必须和路由定义中{slug}完全一致 - 可选参数（带默认值）可以省略，比如路由定义为
/post/{slug}/{locale?}，传{slug: 'x'}就够了，locale会自动用默认值 - 中文或特殊字符做 slug？确保控制器里已用
transliterator_transliterate()或Slugify处理过，否则生成的 URL 可能被浏览器截断或 404
多语言（locale）路由链接怎么生成
如果用了 Symfony 的 symfony/routing 多语言支持（比如通过 _locale 参数或前缀），path() 默认不自动带 locale，得手动传。
- 路由定义含
_locale参数：@Route("/{_locale}/post/{slug}", requirements={"_locale": "en|fr|de"})→ 模板里必须显式传：{{ path('app_post_show', {_locale: 'fr', slug: 'mon-article'}) }} - 没传
_locale？生成的链接会丢 locale，跳转后可能 fallback 到默认语言，或触发 404（如果路由没设默认值） - 不想每个链接都写
_locale？可在 Twig 全局变量里注入当前 locale（比如在 base 模板里{% set current_locale = app.request.get('_locale')|default('en') %}），然后统一用{{ path('xxx', {_locale: current_locale, ...}) }}
常见报错和绕不过去的坑
最常卡住人的不是语法，而是路由名不存在、参数类型不匹配、或缓存没清。
-
Unable to generate a URL for the named route "xxx" as such route does not exist→ 检查路由名拼写，运行php bin/console debug:router看是否真注册了，注意大小写和下划线 -
Some mandatory parameters are missing ("slug")→ 路由定义里是必填参数，但调用时没传，或传了null/ 空字符串（空字符串不等于缺失，但某些正则requirements会拒绝） - 本地开发正常，生产环境 500？大概率是 Twig 缓存没更新，删掉
var/cache/prod/twig/目录再试 - 用了
RedirectResponse或redirectToRoute()重定向到某路由，但模板里还手写了 URL → 保持统一，别混用，否则 locale 或 HTTPS 配置容易不一致
真正麻烦的从来不是函数怎么写，而是路由名是否全局唯一、参数是否在所有场景下都有值、locale 是否被透传到每一层 —— 这些地方一漏，链接就静默失效，连控制台都不报错。
