服务端渲染中虚拟dom仅用于生成html字符串,不执行diff、patch或响应式追踪,静态内容被预编译优化,hydration阶段才启用完整虚拟dom能力。

Vue 在服务端渲染(SSR)时,虚拟 DOM 的作用和行为与客户端有本质区别——它不用于更新页面,而是作为「一次性渲染描述工具」生成 HTML 字符串。
服务端没有真实 DOM,虚拟 DOM 只负责“产出”而非“更新”
服务端运行在 Node.js 环境中,没有浏览器 API,也就没有 document、window 或真实的 DOM 节点。此时 Vue 的虚拟 DOM 不参与 diff、不触发 patch、不操作任何真实节点,它的唯一任务是:根据组件状态,递归生成结构准确的 vnode 树,再由 Vue 的服务端渲染器(renderer)将这棵树序列化为 HTML 字符串。
- 客户端虚拟 DOM:用于对比(diff)、打补丁(patch)、局部更新真实 DOM
- 服务端虚拟 DOM:仅用于构建、遍历、转成字符串,全程无重排/重绘概念
- vnode 对象结构一致,但生命周期钩子(如 mounted、updated)和服务端渲染器内部逻辑完全不同
服务端渲染跳过响应式追踪和异步更新队列
在 SSR 中,Vue 会禁用大部分响应式系统功能。data、computed、watch 等仍可工作,但不会建立依赖收集,也不会触发 effect 更新调度。因为服务端是一次性同步渲染,不需要监听后续变化。
- 不执行 queueJob 或 queuePostFlushCb,所有 render 同步完成
- 不创建 proxy 代理或 ref 的 track/trigger,vnode 生成后即丢弃
- 避免在服务端触发副作用(如 localStorage、定时器、事件监听),否则会报错或污染上下文
静态提升和编译时优化在 SSR 中依然生效
Vue 3 的模板编译器在构建阶段就对静态内容做了标记(如 PatchFlag),这些标记在 SSR 时被服务端 renderer 识别并跳过动态处理,直接输出静态 HTML 片段,显著提升序列化速度。
- 例如:
<div class="header"><h1>标题</h1></div>被标记为 HOISTED,渲染器直接复用预编译的字符串 - 动态绑定(如
:class、v-if)才触发 vnode 构建和条件判断逻辑 - 这意味着 SSR 输出的 HTML 更精简,首屏可交互时间更短
客户端激活(Hydration)才是虚拟 DOM 再次登场的时刻
服务端返回 HTML 后,客户端 Vue 会启动 hydration 过程:用相同的 vnode 结构去“匹配”已存在的 DOM 节点,而不是重新挂载。此时虚拟 DOM 才恢复完整能力——开始收集响应式依赖、注册事件、启用 diff。
- hydration 要求服务端和客户端 vnode 结构严格一致,否则会警告甚至降级为客户端重渲染
- 像
document.body.scrollTop、new Date()这类客户端专属 API 必须包裹在onMounted或process.client判断中 - 服务端渲染出的 vnode 是“只读快照”,客户端 hydration 后的 vnode 才具备响应式更新能力
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











