核心是“数据驱动视图”：后端返回含path、name、component路径、meta等字段的菜单数据，前端解析过滤、router.addRoute动态注册、递归组件渲染菜单，并通过Pinia持久化+守卫恢复实现刷新不丢失。
Vue 动态路由实现后台管理系统动态菜单渲染，核心是“数据驱动视图”——菜单结构由后端返回的权限数据决定，前端只负责解析、过滤和递归渲染，不硬编码菜单项。关键不在怎么写 v-for，而在于整条链路如何闭环：登录 → 拿权限数据 → 筛选路由 → 注册路由 → 渲染菜单 → 高亮联动。
后端返回菜单数据要带完整路由信息
菜单不是单纯的文字列表，而是可直接转为 Vue Router 配置的结构。典型字段包括：path、name、component（或 componentPath）、meta.title、meta.icon、children。推荐使用扁平化+嵌套混合结构，例如：
- 一级菜单：{ path: '/system', name: 'System', meta: { title: '系统管理', icon: 'setting' } }
- 二级菜单：{ path: '/system/user', name: 'SystemUser', component: '@/views/system/User.vue', meta: { title: '用户管理' } }
- 支持 children 的分组：{ path: '/system', redirect: '/system/user', children: [...] }
注意：component 字段建议传字符串路径（如 '@/views/xxx.vue'），便于后续用 import() 动态加载；避免直接传组件对象，否则无法做懒加载和权限隔离。
前端用 addRoute 动态注册，而非全量替换
Vue Router 4 不再提供 addRoutes，而是用 router.addRoute() 单条添加。实际操作中，通常遍历后端返回的菜单数组，对每项调用 addRoute，并递归处理 children。重点细节：
从零开始编排 SpringBoot+Vue 全栈项目工作流，适用于新建全栈项目或完整脚手架请求，触发后依次调用 product‑spec‑builder（需求调研）等模块。
立即学习“前端免费学习笔记（深入）”；
- 先确保 Layout 组件已声明为父级路由（静态路由中必须存在 path: '/' 对应 layout）
- 每个菜单项的
component需包装成异步函数：component: () => import(pathStr) - 添加完成后，调用
router.replace({ path: router.currentRoute.value.fullPath })刷新路由状态，避免白屏 - 务必在路由守卫
beforeEach中拦截未匹配路由，重定向到 404 页面
菜单组件用递归 + v-for 渲染，不依赖路由表顺序
侧边栏菜单组件需支持任意深度嵌套。常见做法是封装一个 MenuItem 子组件，接收 menuList 数组，内部用 v-for 渲染当前层级，遇到 children 就递归调用自身。关键点：
- 高亮逻辑绑定
$route.path，比对每个菜单项的path是否为当前路径前缀（注意含子路由场景） - 隐藏无权限的菜单项：在递归前先按
meta.roles或meta.permission过滤，不满足则跳过渲染 - 图标和标题从
meta中读取，支持 i18n 多语言键（如 meta.title: 'menus.user'） - 点击菜单时用
router.push({ name: item.name })跳转，比 path 更安全（避免拼接错误）
刷新页面后菜单不丢失，靠路由持久化+状态恢复
用户刷新页面，token 还在 localStorage，但动态路由已丢失。解决方案是：在应用初始化阶段（如 main.ts 或 permission store setup 时）检查 token，若存在则立即拉取菜单接口并重新 addRoute。流程如下：
- App 启动 → 检查 localStorage.token 是否有效
- 有效则调用
getMenuList()接口 - 拿到数据后执行路由注册逻辑
- 最后跳转到原页面或默认首页（router.push()）
- 整个过程可在 Pinia 的 permission store 中统一管理，避免多处重复逻辑
不复杂但容易忽略
