ci4 的 $routes->group() 必须用闭包调用，不能赋值；前缀不带斜杠，嵌套时路径叠加；不支持方法限定参数，需在闭包内设 filter、namespace 等；与 ci3 语法完全不兼容。
CI4 中的 $routes->group() 必须用闭包，不能直接赋值
很多人照着 CI3 的写法在 CI4 里写 $routes->group('admin') = function() {...}，结果路由完全不生效——因为 CI4 的 group() 是一个方法调用，返回的是一个可链式操作的路由实例，不是变量赋值目标。它必须紧跟闭包，且闭包参数必须接收 $routes 实例本身。
常见错误现象：404、访问 /admin/users 时进不到控制器、php spark routes 命令不显示该组下任何路由。
- 正确写法：
$routes->group('admin', function($routes) { $routes->get('users', 'AdminUsers::index'); }); - 闭包内不能再用
$routes = service('routes')或重新获取实例，否则会脱离当前分组上下文 - 路径前缀自动拼接，
group('api/v1')+get('users')→ 实际匹配/api/v1/users
路由分组嵌套时，前缀是叠加的，不是覆盖的
CI4 允许 group() 嵌套，但新手常误以为内层 group('v2') 会“重置”路径，实际是字符串拼接。比如 group('api') 内再 group('v2')，最终前缀是 api/v2，不是单独的 v2。
使用场景：为不同 API 版本或权限域（如 admin、api、public）隔离路由逻辑，避免重复写前缀。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 嵌套示例：
$routes->group('api', function($routes) { $routes->group('v1', function($routes) { $routes->get('posts', 'ApiV1Posts::index'); }); });→ 匹配/api/v1/posts - 注意斜杠：每个
group()的字符串**不带开头或结尾斜杠**，框架自动处理，写成group('/api/')会导致双斜杠或匹配失败 - 嵌套过深（>3 层）会让调试变困难，建议用命名空间+控制器前缀替代部分嵌套
$routes->group() 不支持 HTTP 方法限定，需在内部显式指定
你不能写 $routes->group('api', ['filter' => 'auth'])->post('login', ...) 这类带选项的 group 调用——CI4 的 group() 方法只接受字符串前缀和闭包，所有过滤器、HTTP 方法限制、命名空间等都得在闭包内部逐条设置。
性能影响：分组本身无运行时开销，但若在 group 内反复调用 $routes->setNamespace() 或 $routes->setFilter()，要注意作用域是否符合预期（它们只对后续定义的路由生效，不影响已定义的）。
- 正确加 filter：
$routes->group('admin', function($routes) { $routes->setFilter('role:admin'); $routes->get('dashboard', 'AdminDashboard::index'); }); - 错误写法：
$routes->group('admin', ['filter' => 'role:admin'], function($routes) {...})—— 第二个参数会被忽略 - 命名空间要手动设：
$routes->setNamespace('AppControllersAdmin')，否则默认仍是AppControllers
CI3 和 CI4 的分组语法差异极大，混用必报错
CI3 根本没有 $routes->group()，它的“分组”靠手写前缀（如 $route['admin/users'] = 'admin/users'）或第三方扩展实现。如果你从 CI3 升级上来，看到文档里有 group 就直接抄，大概率整个路由文件加载失败，或触发 Fatal error: Call to undefined method CodeIgniter\Routing\RouteCollection::group()。
容易踩的坑：升级后保留旧版 routes.php 文件，又新建了 CI4 风格的 Routes.php，但没删旧文件；或者在 CI4 项目里误用了 CI3 的 $route 数组写法。
- CI4 路由文件路径是
app/Config/Routes.php，内容必须以<?php开头，且第一行通常是use CodeIgniter\Routing\RouteCollection; - CI4 改完路由后必须清缓存：
php spark cache:clear或删writable/cache下对应文件，否则新分组不生效 - CI3 的
application/config/routes.php在 CI4 中被完全忽略，哪怕它还存在
group()。
