Skip to content

水合(Hydration)

一句话解释

水合将静态服务端渲染 HTML 转变为完全可交互的 React 应用,通过附加事件处理。

用大白话说

水合是 React 接收服务端渲染的 HTML 并使其可交互的过程。服务端发送 HTML(快速首屏),然后 React 在客户端运行并「水合」该 HTML:1. 附加事件监听器——onClick、onChange 等

  1. 设置状态——初始化 hooks
  2. 构建虚拟 DOM——匹配服务端 HTML

如果服务端 HTML 和客户端 React 树不匹配,你会收到水合不匹配警告。React 18 的 hydrateRoot 支持选择性水合——可以独立水合页面部分,甚至可以在所有 HTML 下载完成之前水合。

示例

jsx
import { hydrateRoot } from "react-dom/client";
import App from "./App";

// Server sends HTML, client hydrates it
// HTML: <div id="root"><button>Count: 0</button></div>

hydrateRoot(
  document.getElementById("root"),
  <App />
);

// React 18: selective hydration
// Only hydrates what's visible, can pause for user interaction

hydrateRoot 将 React 附加到现有服务端 HTML。React 18 可以选择性水合并为紧急用户事件中断水合。

常见混淆

  • 容易混淆的对象: 渲染

    关键区别: 渲染从 React 组件创建初始 DOM。水合接收现有 DOM(来自服务端 HTML)并附加 React 的事件系统和状态。渲染从头构建;水合连接到已存在的东西。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表