====== 水合(Hydration) ======
**一句话**:水合是"服务端已经把 HTML 送到浏览器之后,前端的 JavaScript 再回过头来接管这份已经画好的 DOM,把它从一张静态图片变成可交互程序"的过程。
===== 1. 这个名字的比喻 =====
服务端渲染出来的 HTML 是**脱水**的:内容全都在,能看、能被搜索引擎和爬虫读,但**没有任何交互能力**——按钮点不动,输入框不响应,因为页面上的事件监听、组件状态、响应式数据都还不存在。
水合就是往这份干巴巴的 HTML 上"**加水**",让它活过来。对应的反面动作叫**脱水(dehydrate)**:把客户端状态序列化成 JSON 塞进 HTML(常见于 `window.__INITIAL_STATE__` 这类全局变量),等待浏览器端还原。
===== 2. 水合到底做了什么 =====
- 服务端用**同一套组件代码**渲染出 HTML 字符串,浏览器先把它显示出来(用户立刻看到完整内容)
- 浏览器下载并执行页面所需的 JS bundle
- 框架遍历**已有的 DOM**,与客户端组件的虚拟树逐节点比对
- 比对通过后,在现有 DOM 节点上**挂事件监听**、**恢复状态**、**执行副作用**
关键点:水合是**复用** DOM,不是重新创建。这是它和纯客户端渲染最容易混淆的地方。
// React 18:水合 —— 复用服务端 DOM
import { hydrateRoot } from 'react-dom/client';
hydrateRoot(document.getElementById('root'),
React 17 及更早版本对应的是 `ReactDOM.hydrate()`;Vue 3 里则是隐式的——用 `createSSRApp()` 创建的应用 `mount()` 到服务端渲染的容器时,框架自动走水合分支。
===== 3. 常见坑 =====
- **水合不一致(hydration mismatch)**:服务端与客户端渲染结果对不上时,框架会报错并**丢弃服务端 DOM 重新渲染一遍**——SSR 白做了。典型诱因:`Math.random()`、`Date.now()`、`typeof window !== 'undefined'` 分支、`localStorage` 取值、非法的 HTML 嵌套(如 `
` 里套 `