thinkphp 8 注解路由需手动安装 think-annotation 扩展、调用 annotationroute::init() 初始化、配置 scan 命名空间、使用 php 8 属性语法 #[route] 并清缓存，否则完全不生效。
注解路由在 ThinkPHP 8 中默认完全不生效，不是“写上就跑”，必须手动安装扩展、显式初始化、且严格遵循目录与语法规范——漏掉任一环节，php think route:list 就看不到任何注解路由。
为什么 @Route 或 #[Route] 完全没反应？
ThinkPHP 8 不再内置注解路由能力，topthink/think-annotation 是独立扩展包，未安装或未初始化时，所有注解都会被 PHP 解析器忽略，框架压根不扫描、不注册。
- 执行
composer require topthink/think-annotation（TP8.0+ 必须手动装，不会自动注册） - 在
app/bootstrap.php末尾添加：AnnotationRoute::init(); - 确认
config/annotation.php存在且未被误删（安装后自动生成） - 修改后必须清缓存：
php think clear:route，否则旧缓存会掩盖配置变化
#[Route] 和 @Route 到底该用哪个？
取决于你用的 PHP 版本和 ThinkPHP 配置方式。TP8 默认启用 PHP 8 属性语法，@Route（DocBlock 注释）在新项目中已不推荐，且容易因格式错误失败。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- PHP 8.0+ 项目：必须用
#[Route('GET', 'user/:id')]，需use think\annotation\route\Route; - PHP 7.x 或兼容旧代码：可用
/** @Route("GET", "user/:id") */，但注释块内不能有单引号（如'user'），否则解析器直接跳过整行 - IDE 支持差异大：PHPStorm 对
#[...]有完整补全和类型提示；对 DocBlock 注解需额外装插件，且常误报
多应用下注解路由找不到控制器？
默认只扫描 app\controller 命名空间，app\admin\controller 或 app\api\controller 这类多应用结构会被跳过。
- 打开
config/annotation.php，找到'scan' => [...]配置项 - 把你的应用控制器命名空间加进去，例如：
'app\admin\controller', 'app\api\controller' - 确保对应目录存在且命名空间与路径严格一致（
app/admin/controller/User.php→namespace app\admin\controller;） - 控制器类必须是
public方法，且不能是static或private，否则扫描器直接过滤
#[Route] 的参数怎么填才不踩坑？
#[Route] 是通用注解，#[Get]/#[Post] 是快捷方式，但它们底层都转成 #[Route]。关键区别在默认行为和可选参数范围。
- 基础写法：
#[Route('GET', 'user/:id')]—— 第一个参数是 method，第二个是 path - 指定中间件：
#[Route('GET', 'user/:id', middleware: ['auth'])]（注意用冒号赋值，不是等号） - 多个 method：
#[Route(['GET', 'HEAD'], 'user/:id')，不能写成method: ['GET','HEAD'] - 路径参数类型校验要靠
pattern，但#[Route]本身不支持直接写正则，得配合全局 pattern 或分组定义 - 别在注解里写中文路径或空格，URL 解析会失败，比如
#[Route('GET', '用户列表')]必报错
最常被忽略的一点：注解必须紧贴方法声明上方，中间不能有任何空行或注释隔开；方法必须位于 app/controller/（或多应用对应路径）下，且类能被 Composer 自动加载 —— 否则扫描器根本看不到它。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
