Vue 3.5.46 修的是过期回调与缓存时序:Transition、Suspense、KeepAlive 的一批竞态补丁
Vue 3.5.46(2026-11-20)这批补丁没有新特性。把修复列表按模块拆开看,绝大多数都指向同一类问题:组件被复用、被丢弃、被替换时,上一轮留下的回调、错误和 hook 没有被及时作废,于是串到了新一轮渲染上。表现是动画播两遍、动画不消失、mounted 跑两次、卸载后仍抛错。下面是按模块的整理,以及怎么判断自己是否踩到了这些 bug。
Transition:过期回调串到复用元素上
三个补丁都围绕复用元素:
- 忽略复用元素上过期的
enter回调。元素被复用时,旧的那次enter回调如果没被丢弃,会在新元素上再触发一次进场,表现为二次进场或动画从头再播一遍。 - 忽略复用元素上过期的
leave回调(#16358)。旧leave回调残留会让一个已经不需要离开的元素继续走离场流程,典型症状是leave-active之类的类名一直挂着、动画结束回调不触发、元素看起来“卡住不消失”。 - 只对正在离开的元素跳过
enter(#16362,fix #16359)。此前的跳过条件放得过宽,把本该正常进场的元素也跳过了,导致该有动画的地方没动画。
Suspense:mounted 重复、错误与 hook 的丢弃
out-in边界在 pending 祖先内部 resolve 时,mountedhook 只运行一次(#16345)。重复触发的mounted会让依赖挂载时机的副作用初始化跑两遍。- 卸载组件丢弃 async
setup的错误(#16350)。组件已经卸载,setup的 Promise 再 reject 就成了没有归属的未捕获错误。 - pending 分支被卸载时丢弃
unmounthook,以及 3.5.45 里同一批的:边界卸载后不挂载 fallback、pending 分支内嵌套的 transition 在 reveal 时进入、被丢弃的组件保持 unmounted 标记、async root 更新重试跨被丢弃分支保留、被丢弃组件的内部清理保留、pending 期间 root 再次切换时保留 timeout 计数。这些都在保证一件事:被丢弃的分支不能留下还会执行的回调。
KeepAlive:缓存时机
KeepAlive 的两条在 3.5.45 中已合入:已 resolve 的 Suspense 子组件立即缓存;缓存之前就被 deactivate 的子组件要被卸载,而不是留在缓存里成为一个没有完成激活流程的条目。
Teleport + SSR:CSS 变量注入与锚点认领
compiler-ssr把 CSS 变量注入 keep-alive 和 teleport 的内容;ssr通过根循环和 fragment 注入 CSS 变量。此前 SSR 输出里这些内容拿不到父级注入的 CSS 变量。runtime-dom对“未 patch teleport 就被替换”的 teleport 内容应用 CSS 变量(#16239,关闭 #7312 #7344 #16237 #16238)。这条对应的是客户端接管或内容被整体替换时样式变量丢失。hydration在嵌套 teleport 之前先认领 disabled teleport 的目标锚点(#16333)。认领顺序错了,后面嵌套 teleport 的锚点就会对不上,hydration mismatch 随之出现。- 同一批
compiler-ssr还把静态 DOM prop 别名映射到 HTML 属性名,ssr避免继承属性到属性的映射。
compiler-sfc:tsconfig 与作用域
include/exclude模式相对 config 文件匹配,configDir也相对被引用的 config 解析。此前从不同工作目录跑构建,匹配结果会变。- 保留泛型类型参数作用域,以及尊重
catch/switch的词法作用域(后者在 3.5.45)。 - 尊重用户提供的
onWarn选项,并输出内联模板提示(#16152)。自定义onWarn之前拿不到这些提示。
其余零散项:compiler-core 的 cloneLoc 复制 loc 而不是重算、compiler-dom 保留静态 boolean binding 语义、HMR 在 pending async root resolve 后重试 reload、reactivity 的 onScopeDispose 在已停止的 scope 中运行、runtime-core 组件根无 el 时用 async placeholder 作锚点、指令 mounted hook 拿到最新 binding、runtime-dom 把 disablepictureinpicture / disableremoteplayback 按 boolean 属性处理、shared 的 looseEqual 处理无原型对象。
3.6 还是 RC,生产留在 3.5.46
3.6 未正式发布,3.6.0-rc.16 于 2026-11-20 发布,rc.15 在 11-12,改动集中在 Vapor 相关功能。3.6 带两件大事:基于 alien-signals 的 @vue/reactivity 大重构(性能与内存),以及 Vapor Mode——opt-in,支持 template-only SFC 与 ``,不支持 Options API,依赖 VNode 或组件公共实例 proxy 的特性在 Vapor 组件里不可用。生产线上最新补丁版本是 3.5.46,升级时不要只看补丁号就顺手抬到 3.6 RC。
症状对照
- 元素进场动画播两次、或离场动画结束后元素不消失、
leave相关类名残留 → Transition 的三条(#16358、#16362、过期 enter 回调)。 - 同一组件
mounted打印两次、挂载副作用重复注册 → #16345。 - 控制台出现来自已卸载组件的 async
setup未捕获错误 → #16350。 - Suspense 边界卸载后仍然渲染 fallback、pending 分支的清理函数仍执行、pending 期间反复切换导致 timeout 计数异常 → 3.5.45 的 suspense 一批。
- 被 Suspense resolve 的 KeepAlive 子组件重新进入时重新创建、缓存中出现未完成激活的实例 → KeepAlive 两条。
- SSR 输出里 keep-alive / teleport 内容样式变量丢失、disabled teleport 的 hydration mismatch → compiler-ssr 与 #16239、#16333。
- monorepo 里
include/exclude结果随执行目录变化、自定义onWarn收不到内联模板提示、泛型参数在编译后丢作用域 → compiler-sfc 四条。
升级验证建议
- 先在 lockfile 里把
vue固定到 3.5.46,同时确认@vue/compiler-sfc、vue/server-renderer等包版本一致,避免编译器与运行时错配。 - 为上面每条症状准备一个最小复现:复用元素的 transition、Suspense 嵌套 out-in、KeepAlive + Suspense、disabled teleport 的 SSR hydration。升级前后各跑一次比对行为。
- SFC 编译相关的改动要在实际构建命令下验证,尤其是 monorepo 中 tsconfig 被多层引用的项目。
- 3.6 的验证单独开分支,重点看
@vue/reactivity重写后的行为和是否启用了 Vapor;依赖组件实例 proxy 的代码在 Vapor 组件里不适用。