路由文件不生效需确认加载路径和返回值：route.php必须在bootstrap.php等入口显式引入，且必须返回闭包或Route对象；多文件用Route::import()拆分但需注意路径和返回值；修改后需清缓存php think route:clear。
路由文件不生效？确认 route.php 加载路径和返回值
ThinkPHP 6+ 默认不会自动加载任意位置的路由文件，必须由框架明确引入。常见错误是把 route.php 放在 app/route/ 下却没在 app/provider.php 或 app/bootstrap.php 中显式 require，结果路由完全不注册。
正确做法是确保入口处（如 app/bootstrap.php）有类似代码：
if (is_file($routeFile = __DIR__ . '/route.php')) {
require $routeFile;
}
注意：route.php 必须 返回一个闭包或 Route 对象，不能只写 Route::get(...) 而不返回，否则框架无法识别为有效路由定义。
多个路由文件怎么组织？用 Route::import() 拆分但别滥用
想按模块拆分路由（比如 admin.php、api/v1.php），可以用 Route::import()，但它不是“自动扫描”，而是显式加载——路径写错、文件不存在、返回值为空都会静默失败，没有任何报错提示。
立即学习“PHP免费学习笔记（深入）”；
推荐结构和写法：
-
app/route/下放app.php（主入口）、admin.php、api.php -
app.php里写：Route::import('admin', 'route.admin');（第二个参数是命名空间前缀，可选） - 每个子文件末尾必须
return function () { ... };或直接return Route::rule(...);
⚠️ 注意：Route::import() 不支持嵌套 import，也不支持通配符路径；它只是简单 require 并执行，没有容错机制。
为什么改了路由配置没反应？检查 route_cache 和 APP_DEBUG
开发时最常踩的坑：改完 route.php 刷新页面没变化。大概率是缓存没清，或者环境配置锁死了路由加载逻辑。
关键点：
- 生产环境默认开启
route_cache，修改路由后必须手动运行：php think route:clear -
APP_DEBUG = false时，框架会跳过部分动态加载逻辑，包括某些条件判断下的路由注册分支 - 如果用了多应用模式（
app/multi），路由文件路径变成app/{name}/route.php，且需在应用配置中启用route_config_file
调试建议：临时加一行 dump('route loaded'); 在 route.php 开头，看是否被执行，比猜更直接。
Route::rule() 和 Route::get() 的性能差异其实可以忽略
有人纠结该用快捷方法（Route::get()）还是通用方法（Route::rule()），其实底层都是调同一个注册流程，差异仅在于参数解析阶段——对千级以下路由，耗时差不到 0.01ms。
真正影响性能的是：
- 路由规则中用了正则捕获（
:id\d+）且未加?限制长度，导致 PCRE 回溯爆炸 - 大量使用
/:name$这类模糊通配，让匹配顺序变长 - 在路由闭包里做了数据库查询或远程调用（这根本就违背路由职责）
所以优先选读得懂的写法：Route::get('user/:id', 'user/read') 比 Route::rule('user/:id', 'user/read', 'GET') 更直观，也更少出错。
