差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 代码术语:水合 [2026/10/14 01:03] – 创建 张叶安 | 代码术语:水合 [2026/10/14 08:49] (当前版本) – 填写「水合(Hydration)」术语说明 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== 水合(Hydration) ====== |
| + | |||
| + | **一句话**:水合是" | ||
| + | |||
| + | ===== 1. 这个名字的比喻 ===== | ||
| + | |||
| + | 服务端渲染出来的 HTML 是**脱水**的:内容全都在,能看、能被搜索引擎和爬虫读,但**没有任何交互能力**——按钮点不动,输入框不响应,因为页面上的事件监听、组件状态、响应式数据都还不存在。 | ||
| + | |||
| + | 水合就是往这份干巴巴的 HTML 上" | ||
| + | |||
| + | ===== 2. 水合到底做了什么 ===== | ||
| + | |||
| + | - 服务端用**同一套组件代码**渲染出 HTML 字符串,浏览器先把它显示出来(用户立刻看到完整内容) | ||
| + | - 浏览器下载并执行页面所需的 JS bundle | ||
| + | - 框架遍历**已有的 DOM**,与客户端组件的虚拟树逐节点比对 | ||
| + | - 比对通过后,在现有 DOM 节点上**挂事件监听**、**恢复状态**、**执行副作用** | ||
| + | |||
| + | 关键点:水合是**复用** DOM,不是重新创建。这是它和纯客户端渲染最容易混淆的地方。 | ||
| + | |||
| + | <code javascript> | ||
| + | // React 18:水合 —— 复用服务端 DOM | ||
| + | import { hydrateRoot } from ' | ||
| + | hydrateRoot(document.getElementById(' | ||
| + | |||
| + | // 对比:客户端渲染 —— 从零造 DOM,服务端 HTML 会被丢弃 | ||
| + | import { createRoot } from ' | ||
| + | createRoot(document.getElementById(' | ||
| + | </ | ||
| + | |||
| + | React 17 及更早版本对应的是 `ReactDOM.hydrate()`;Vue 3 里则是隐式的——用 `createSSRApp()` 创建的应用 `mount()` 到服务端渲染的容器时,框架自动走水合分支。 | ||
| + | |||
| + | ===== 3. 常见坑 ===== | ||
| + | |||
| + | - **水合不一致(hydration mismatch)**:服务端与客户端渲染结果对不上时,框架会报错并**丢弃服务端 DOM 重新渲染一遍**——SSR 白做了。典型诱因:`Math.random()`、`Date.now()`、`typeof window !== ' | ||
| + | - **" | ||
| + | - **是" | ||
| + | |||
| + | ===== 4. 相关术语对照 ===== | ||
| + | |||
| + | ^ 术语 ^ 含义 ^ | ||
| + | | CSR | 纯浏览器端渲染,没有水合一环,只有首次渲染 | | ||
| + | | SSR | 服务端渲染出 HTML,通常伴随水合 | | ||
| + | | SSG | 构建时预渲染成静态 HTML,打开时同样需要水合 | | ||
| + | | 脱水 Dehydrate | 把状态序列化进 HTML,供客户端还原 | | ||
| + | | 同构 Isomorphic | 同一份代码既能在服务端跑也能在浏览器跑,是水合能成立的前提 | | ||
| + | |||
| + | ===== 5. 演进方向 ===== | ||
| + | |||
| + | - **局部水合 / 岛屿架构(Islands)**:只给真正需要交互的" | ||
| + | - **渐进式、可中断水合**:按优先级切片水合,先让首屏按钮可用 | ||
| + | - **React Server Components**:组件留在服务端," | ||
| + | - **Resumability**:干脆不重放组件逻辑,直接续上服务端的执行现场,代表是 Qwik | ||
| + | |||
| + | ===== 6. 别处的" | ||
| + | |||
| + | 这个词并不只属于前端。**ORM / 数据库**语境里,把查询返回的行数据填充成对象实例,同样叫 hydrate(Hibernate、Sequelize、Mongoose 都有类似用法);某些模板引擎、缓存层也叫这个名。 | ||
| + | |||
| + | 语义是统一的:**先把数据准备好(干),再" | ||
| + | |||
| + | ---- | ||
| + | |||
| + | 相关:[[代码术语: | ||