代码术语:水合

水合(Hydration)

一句话:水合是“服务端已经把 HTML 送到浏览器之后,前端的 JavaScript 再回过头来接管这份已经画好的 DOM,把它从一张静态图片变成可交互程序”的过程。

服务端渲染出来的 HTML 是脱水的:内容全都在,能看、能被搜索引擎和爬虫读,但没有任何交互能力——按钮点不动,输入框不响应,因为页面上的事件监听、组件状态、响应式数据都还不存在。

水合就是往这份干巴巴的 HTML 上“加水“,让它活过来。对应的反面动作叫脱水(dehydrate):把客户端状态序列化成 JSON 塞进 HTML(常见于 window.__INITIAL_STATE__ 这类全局变量),等待浏览器端还原。

  • 服务端用同一套组件代码渲染出 HTML 字符串,浏览器先把它显示出来(用户立刻看到完整内容)
  • 浏览器下载并执行页面所需的 JS bundle
  • 框架遍历已有的 DOM,与客户端组件的虚拟树逐节点比对
  • 比对通过后,在现有 DOM 节点上挂事件监听、恢复状态、执行副作用

关键点:水合是复用 DOM,不是重新创建。这是它和纯客户端渲染最容易混淆的地方。

// React 18:水合 —— 复用服务端 DOM
import { hydrateRoot } from 'react-dom/client';
hydrateRoot(document.getElementById('root'), <App />);
 
// 对比:客户端渲染 —— 从零造 DOM,服务端 HTML 会被丢弃
import { createRoot } from 'react-dom/client';
createRoot(document.getElementById('root')).render(<App />);

React 17 及更早版本对应的是 ReactDOM.hydrate();Vue 3 里则是隐式的——用 createSSRApp() 创建的应用 mount() 到服务端渲染的容器时,框架自动走水合分支。

  • 水合不一致(hydration mismatch):服务端与客户端渲染结果对不上时,框架会报错并丢弃服务端 DOM 重新渲染一遍——SSR 白做了。典型诱因:Math.random()、Date.now()、typeof window !== 'undefined' 分支、localStorage 取值、非法的 HTML 嵌套(如 <p> 里套 <div>,浏览器会自动修正结构)。
  • “看起来好了,其实点不动”:HTML 到达即可见,但可交互要等 JS 下载 + 解析 + 执行 + 水合全部完成。大页面下这段空窗期可能长达数秒,是 SSR 站点体感卡顿的主因。
  • 是”全量、一次性”的:传统水合必须整页做完才可用,很难只激活其中一块。
术语 含义
CSR 纯浏览器端渲染,没有水合一环,只有首次渲染
SSR 服务端渲染出 HTML,通常伴随水合
SSG 构建时预渲染成静态 HTML,打开时同样需要水合
脱水 Dehydrate 把状态序列化进 HTML,供客户端还原
同构 Isomorphic 同一份代码既能在服务端跑也能在浏览器跑,是水合能成立的前提
  • 局部水合 / 岛屿架构(Islands):只给真正需要交互的“岛”水合,其余保持纯静态,代表是 Astro
  • 渐进式、可中断水合:按优先级切片水合,先让首屏按钮可用
  • React Server Components:组件留在服务端,“不需要水合的组件”比例越来越高
  • Resumability:干脆不重放组件逻辑,直接续上服务端的执行现场,代表是 Qwik

这个词并不只属于前端。ORM / 数据库语境里,把查询返回的行数据填充成对象实例,同样叫 hydrate(Hibernate、Sequelize、Mongoose 都有类似用法);某些模板引擎、缓存层也叫这个名。

语义是统一的:先把数据准备好(干),再“加水”让结构变成可用的活对象。 看到“水合”两个字,先判断上下文是 SSR 还是 ORM,方向就不会错。


相关:一文讲清楚什么是next_node_shadcn_express

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 代码术语/水合.txt
  • 最后更改: 2026/10/14 08:49
  • 由 张叶安