Vue 的 reactive 不直接维护动态路由菜单，而是作为响应式容器配合路由逻辑与状态管理实现视图自动更新：需将后端菜单转为 reactive 对象并存入 Pinia/Vuex，通过清空再批量赋值保持响应性，菜单组件直接使用该 reactive 数据递归渲染，并协同 router.addRoute() 同步注册路由。
Vue 的 reactive 本身不直接“维护”动态路由菜单，而是作为响应式数据容器，配合路由处理逻辑和状态管理，让菜单数据变化时能自动触发视图更新。关键在于：把后端返回的菜单结构转为 reactive 对象，并确保它被正确注入到菜单组件中。
菜单数据用 reactive 包裹并存入 Pinia/Vuex
登录成功后，从接口拿到原始菜单数组（如含 path、name、title、icon、children 等字段），不要直接赋值给普通对象：
- 在 store（如 Pinia）中定义一个
menuList = reactive([])或menuList = ref([]) - 调用接口后，清空再批量赋值：
menuList.length = 0; menuList.push(...transformedRoutes)，避免替换整个引用导致响应失效 - 确保转换函数（如扁平转树、过滤隐藏项、补全
component异步导入）返回的是标准 JS 对象，reactive才能正常代理
菜单组件接收 reactive 数据并递归渲染
侧边栏组件（如 Sidebar.vue）通过 useStore 获取 menuList，直接用于 v-for 渲染：
- 不手动解构
menuList，例如避免const { list } = store，否则会丢失响应性 - 使用
v-for="item in menuList"+isMenuItem(item)判断是否展示（基于meta.hideInMenu或权限字段） - 子菜单递归时，传入
item.children——只要它是 reactive 数组的子项，嵌套更新也会触发重绘
配合路由守卫同步 reactive 菜单与 router 实例
reactive 管的是菜单 UI 层，而真实跳转依赖 router.addRoute()。两者需协同：
立即学习“前端免费学习笔记（深入）”；
- 菜单数据处理完成后，再调用
router.addRoute()注册对应路由（注意 Vue Router 4 中推荐用addRoute单条添加，或addRoute(parentName, route)处理嵌套路由） - 不要在
reactive数据里硬编码component: () => import(...)，应在路由注册阶段统一处理；菜单只负责展示字段（title、icon、path） - 若菜单点击后
router.push(path)报错“no match”，说明addRoute未完成 —— 此时应结合next({ to, replace: true })在守卫中兜底重试
避免常见响应性断裂点
以下操作会让 reactive(menuList) 失效：
- 直接
menuList = newArray（应改用menuList.splice(0, menuList.length, ...newArray)） - 对后端返回的菜单做深拷贝后再 reactive（如用 JSON.parse(JSON.stringify())），会丢失原始响应性链路；应在转换逻辑中保持对象引用层级
- 菜单组件中用
computed过滤但未正确 return 响应式数组（应确保 computed 内部访问的是 reactive 源数据）
