Symfony 6.4推荐用PHP属性注解定义路由，如#[Route('/', name: 'home')]，也支持YAML集中配置；需用debug:router验证、cache:clear刷新缓存，并注意命名空间与PHP版本要求。
Symfony 6.4 中定义路由非常直观，核心是把“URL路径”和“控制器方法”对应起来。默认推荐用 PHP 属性注解（Attribute），写法简洁、语义清晰，且 IDE 支持好。YAML 方式仍被广泛使用，适合团队统一管理或需要条件化加载的场景。
注解方式：直接在控制器里写路由
这是 Symfony 6.4+ 的首选方式，无需额外配置文件，代码即文档。
- 确保控制器类在 src/Controller/ 目录下，比如
src/Controller/HomepageController.php - 方法上方加
#[Route]属性，指定路径、HTTP 方法和路由名：
#[Route('/', name: 'home')]
public function index(): Response
{
return $this->render('homepage/index.html.twig');
}
- 支持动态参数：
#[Route('/post/{id}', name: 'post_show', requirements: ['id' => 'd+'])]，其中requirements可限制 ID 必须为数字 - 多个 HTTP 方法可合并：
#[Route('/api/user', methods: ['GET', 'POST'])]
YAML 方式：集中配置，结构清晰
适合中大型项目或需按模块拆分路由时使用。Symfony 自动加载 config/routes.yaml。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 基本写法示例：
app_home:
path: /
controller: AppControllerHomepageController::index
methods: [GET]
app_post_show:
path: /post/{id}
controller: AppControllerPostController::show
requirements:
id: 'd+'
- 可引入其他 YAML 文件实现模块化，例如在主文件中写：
blog_routes: resource: '../src/Controller/BlogController.php' type: annotation - 注意缩进必须是空格，不能用 Tab；
controller值格式为类名::方法名
快速验证与调试技巧
改完路由后别急着刷新页面，先用命令确认是否生效。
- 列出所有已注册路由：
php bin/console debug:router - 查某条 URL 对应哪个控制器：
php bin/console debug:router --show-controllers /post/123 - 修改了路由配置后，记得清缓存：
php bin/console cache:clear（开发环境有时自动处理，但手动执行更稳妥） - 如果路由不匹配，检查控制器命名空间是否正确（应为
AppController）、类是否 public、方法是否 public 且无参数类型冲突
常见问题与应对
新手常遇到几个典型卡点，提前知道能少走弯路。
-
404 报错但路径看起来没错：优先运行
debug:router看该路径是否存在；再确认控制器文件是否放在src/Controller/下，且类名与文件名一致 -
注解不生效：检查是否用了 PHP 8.0+，并确认
symfony/attribute已安装（6.4 默认包含）；旧项目升级后可能需启用 attribute loader -
中文或特殊字符路径报错：在
requirements中放宽正则，如[wu{4e00}-u{9fa5}]+（需开启 u 修饰符，YAML 中写成'[w\u{4e00}-\u{9fa5}]+'）
