当前位置：首页 > news >正文

ReactDOM 18版本使用createRoot 替换render详解

news 2025/7/7 0:23:21

概述

React 18 提供了两个 root API，被称之为 Legacy Root API 和 New Root API：

Legacy Root API：是指之前版本的 root API ReactDOM.render，它将创建一个以 “legacy” 模式运行的 root，其工作方式与 React 17 完全相同。我们会给这个 API 添加一个警告，来说明它将要被弃用并建议切换到 New Root API。
New Root API：新的 root API 是 ReactDOM.createRoot。它可以在 React 18 中创建一个 root，并支持 React 18 中支持的所有新特性。

注意：

Legacy Root API是为了避免用户升级到 React 18 出现问题。React官方向旧的 root API 添加了一个警告，建议使用新 API，并且Eslit会有error类型的错误拦截。

将 ReactDOM.render 替换为 ReactDOM.createRoot 是 React 18 中的一个重要改动，带来了多项改进和新特性。以下是一些主要的好处：

1. 并发特性（Concurrent Features）

自动批处理

React 18 引入了自动批处理（Automatic Batching），它可以将多个状态更新合并为一次渲染，从而提高性能。使用 createRoot 可以自动启用这项功能。

并发渲染（Concurrent Rendering）

并发渲染使得 React 可以在不阻塞主线程的情况下准备新的 UI 更新。当用户进行交互时，React 可以更快地响应和更新界面。createRoot 支持并发渲染，而 ReactDOM.render 不支持。

2. startTransition API

使用 createRoot 可以启用 startTransition API，用于标记低优先级更新。这对于优化性能、避免界面卡顿非常有帮助。


import { startTransition } from 'react';// Example usage
startTransition(() => {setState(newState);
});

3. useDeferredValue 和 useTransition Hook

这些新的 Hook 提供了更灵活的方式来处理异步状态更新和延迟渲染。createRoot 支持这些特性，而 ReactDOM.render 不支持。

4. 流畅的 Suspense 支持

React 18 中的 Suspense 特性得到了增强，提供了更好的加载状态处理和流畅的用户体验。createRoot 完全支持这些改进。

5. 改进的 SSR（Server-Side Rendering）

React 18 提供了改进的服务器端渲染功能，包括流式渲染和并发特性。使用 createRoot 使得客户端和服务端渲染的同步更为流畅。

6. 更好的错误处理

React 18 改进了错误处理机制，使得在开发和生产环境中更容易捕获和处理渲染错误。使用 createRoot 可以更好地利用这些改进。

升级前提：安装最新的 React 和 ReactDOM

确保你已经安装了最新版本的 React 和 ReactDOM。

npm install react@latest react-dom@latest

代码示例：如何使用 createRoot
下面是一个简单的示例，展示了如何将 ReactDOM.render 替换为 ReactDOM.createRoot：

使用 ReactDOM.render 的旧代码：

import React from 'react';
import ReactDOM from 'react-dom';
import App from './App';ReactDOM.render(<React.StrictMode><App /></React.StrictMode>,document.getElementById('root')
);

使用 ReactDOM.createRoot 的新代码：

import React from 'react';
import ReactDOM from 'react-dom/client';
import App from './App';// 获取根节点
const container = document.getElementById('root');// 创建根组件
const root = ReactDOM.createRoot(container);// 渲染根组件
root.render(<React.StrictMode><App /></React.StrictMode>
);