laravel-admin 菜单高亮依赖命名路由，需确保路由调用 ->name() 且菜单项 'route' 值与之完全匹配；支持通配符（如 'admin.users.*'）和逗号分隔多路由；失效常见原因为路由未命名、未加载或中间件拦截。
在 Laravel-admin 中实现菜单高亮当前页面，核心是让系统识别“用户当前访问的路由”并匹配到菜单项。它不依赖 URL 字符串比对，而是基于 Laravel 的命名路由机制完成精准判断。
确保所有菜单项对应命名路由
laravel-admin 的菜单高亮逻辑只认 已命名的路由（即调用了 ->name('xxx') 的路由）。如果路由没命名，即使路径正确，菜单也不会高亮。
- 检查
app/Admin/routes.php中的路由是否都设置了 name：
$router->resource('users', 'UserController')->name('admin.users');
$router->get('profile', [ProfileController::class, 'edit'])->name('admin.profile');
- 菜单配置中（如
app/Admin/bootstrap.php或自定义菜单类），每个菜单项的'route'值必须与上述 name 完全一致：
'Users' => [
'route' => 'admin.users.index', // ✅ 正确：对应 Route::name('admin.users.index')
// 'route' => '/users', // ❌ 错误：无命名、不支持高亮
],
使用 Route::is() 或 request()->routeIs() 判断
laravel-admin 内部默认通过 Route::is($menuRouteName) 来判断当前是否命中该菜单项。你无需手动写逻辑，但需理解其行为：
- 支持通配符匹配，适合模块化菜单：
'Users' => [
'route' => 'admin.users.*', // 高亮 admin.users.index / admin.users.create 等全部子路由
],
- 多个路由名用逗号分隔（内部会自动展开为
Route::is('a', 'b', 'c')）：
'System' => [
'route' => 'admin.roles.index,admin.permissions.index,admin.menu.index',
],
检查路由是否真正被加载和命名
常见高亮失效原因不是代码写错，而是路由未生效：
- 运行
php artisan route:list，确认目标路由出现在列表中且Name列非空 - 若使用了路由组（如
Route::name('admin.')->group(...)），确保 group 内每个路由都明确命名或继承前缀 - 避免在中间件中提前终止请求（如权限拦截返回 403），导致路由虽匹配但未走到菜单渲染阶段
自定义高亮逻辑（进阶）
如需更灵活控制（例如根据控制器+方法、或动态参数判断），可在菜单配置中使用闭包：
'Custom' => [
'route' => function () {
return Route::current()?->getName() === 'admin.posts.show' &&
request()->route('id') == 123;
},
],
该方式绕过默认字符串匹配，直接操作路由实例，适合特殊业务场景。
