编程 Vue 3.5.46 修的是过期回调:Transition 复用元素、Suspense 的 mounted 跑两次都在这批

2026-11-21 21:06:24

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 时,mounted hook 只运行一次(#16345)。重复触发的 mounted 会让依赖挂载时机的副作用初始化跑两遍。
  • 卸载组件丢弃 async setup 的错误(#16350)。组件已经卸载,setup 的 Promise 再 reject 就成了没有归属的未捕获错误。
  • pending 分支被卸载时丢弃 unmount hook,以及 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 四条。

升级验证建议

  1. 先在 lockfile 里把 vue 固定到 3.5.46,同时确认 @vue/compiler-sfc、vue/server-renderer 等包版本一致,避免编译器与运行时错配。
  2. 为上面每条症状准备一个最小复现:复用元素的 transition、Suspense 嵌套 out-in、KeepAlive + Suspense、disabled teleport 的 SSR hydration。升级前后各跑一次比对行为。
  3. SFC 编译相关的改动要在实际构建命令下验证,尤其是 monorepo 中 tsconfig 被多层引用的项目。
  4. 3.6 的验证单独开分支,重点看 @vue/reactivity 重写后的行为和是否启用了 Vapor;依赖组件实例 proxy 的代码在 Vapor 组件里不适用。
复制全文 生成海报 Vue 前端 升级

推荐文章

程序员茄子在线接单