METRICS: CopyDataProperties|浅拷贝 · router.replace|整体覆盖 · Diff key|组件身份 · keep-alive|name 匹配 · Object.is|Watch 陷阱 · sessionStorage|会话隔离 · SSOT|单一事实源
一个旅行 H5 项目里,页面上有“生活 / 行程 / 收藏”三个子页签。用户切换时会跳错目的地,点“返回”又回到错误的页签。团队先怀疑是 query 没拼全,但拼齐之后问题依旧。往下追,才发现它牵出 ECMAScript 规范与 Vue 源码里的多处机制。
一、症状与病根
用户能感知到三类异常:切换页签时高亮错位;从分享链接进入时落到默认页签;返回时激活页签与离开前不一致。
根因是“激活状态”同时依赖 URL Query、localStorage、sessionStorage 三个数据源,却从未定义优先级。下面逐个拆开。
二、...route.query 是规范级浅拷贝
...route.query 对应 ECMAScript 规范里的 CopyDataProperties:遍历源对象自身的可枚举属性,逐个用 [[Get]] 读值,再经 CreateDataPropertyOrThrow 写入目标。基本类型按值复制、引用类型按引用复制,即浅拷贝。
route.query 是扁平结构(Record<string, string>),深拷贝没有意义,还会丢失 Vue 的响应式 Proxy、剥离 undefined、带来额外开销,浅拷贝才是正确选择。
三、router.replace 是整体覆盖
Vue Router 对 query 执行的是整体覆盖,相当于 currentQuery = newQuery,而不是增量合并。
router.replace({ query: { tab: '行程' } }) // 丢弃 hideTab / showBack 等参数
router.replace({ query: { ...route.query, tab: '行程' } }) // 先拷贝旧参数,再覆盖 tab直接传 { tab } 会丢掉 hideTab、showBack、lang 等上下文参数,必须先把旧参数浅拷贝过来。
四、Diff 的 key 是组件身份
Vue 通过 isSameVNodeType 判断节点能否复用,条件是 type === type && key === key。若把 route.fullPath 当作 router-view 的 key,Query 只要微变,fullPath 就变,组件被判为全新节点,触发“销毁 + 重建”,onMounted 里的状态初始化反复执行,放大错乱。
五、KeepAlive 匹配的是组件 name
<keep-alive :include> 匹配组件自身的 name 选项,而不是路由配置里的 name。两者不一致时 include 命不中,缓存失效,页面每次切换都要重新挂载。
六、Watch 用 Object.is 比较
watch(() => tab.value, cb) 内部用 Object.is 比较新旧值。若默认值与 URL 解析值一致(都是 LocalLife),回调不会触发;刷新逻辑若写在回调里,旧数据就会残留。
七、存储与守卫要选对
localStorage 同源共享且持久,新 WebView 会读到历史残余数据,造成跨窗口污染;sessionStorage 按标签页隔离、会话结束即清空,才与当前 WebView 的生命周期对齐,缓存激活状态应当用它。
路由守卫同理:全局 beforeEach 不随组件销毁自动解绑,页内改 Query 也会被拦截;组件级 onBeforeRouteLeave 只在离开路由记录时触发,并随组件卸载注销,语义更准确。
八、收敛到单一事实源
三类缺陷同源:激活状态被多个数据源瓜分。修复办法是确立唯一优先级:
激活状态 = URL Query ‖ sessionStorage ‖ 默认状态URL Query 优先级最高,深链与分享链接直接决定初始状态;无 URL 参数时降级读 sessionStorage;最后用默认值兜底。下面的实验台可以修改三个数据源,观察修复前后的差异。
交互实验室 · 激活状态优先级
随意修改三个数据源,观察「旧逻辑被 localStorage 污染」与「修复后 URL 优先」的差异
URL Query
最高优先级sessionStorage
次级降级源localStorage
旧污染源旧逻辑 · 踩坑(localStorage 抢先)
修复后 · 正确(URL 优先)
修复后的优先级流水线(激活状态 = URL ‖ sessionStorage ‖ 默认)
九、小结
... 是规范级浅拷贝,router.replace 是整体覆盖,Diff 的 key 是组件身份,keep-alive 的 include 匹配组件 name。工程里没有真正的小改动,只有还没追到底的根因。
本文属于 AI 实用主义流派 的第 50 篇肉身实战。
发表评论
分享你的想法和反馈