Menu

reactCompiler

Next.js 支持 React Compiler,这是一个旨在通过自动优化组件渲染来提高性能的工具。这减少了使用 useMemouseCallback 进行手动记忆化的需求。

Next.js 包含一个用 SWC 编写的自定义性能优化,使 React 编译器更加高效。Next.js 不会对每个文件运行编译器,而是分析你的项目并且只将 React 编译器应用于相关文件。这避免了不必要的工作,与单独使用 Babel 插件相比,可以实现更快的构建。

工作原理

React 编译器通过 Babel 插件运行。为了保持构建速度,Next.js 使用自定义 SWC 优化,只将 React 编译器应用于相关文件——比如包含 JSX 或 React hooks 的文件。

这避免了编译所有内容,并将性能成本降到最低。与默认的基于 Rust 的编译器相比,你可能仍会看到稍慢的构建速度,但影响很小且局部化。

要使用它,请安装 babel-plugin-react-compiler

Terminal
npm install babel-plugin-react-compiler

然后,在 next.config.js 中添加 experimental.reactCompiler 选项:

next.config.ts
TypeScript
import type { NextConfig } from 'next'
 
const nextConfig: NextConfig = {
  experimental: {
    reactCompiler: true,
  },
}
 
export default nextConfig

注解

你可以按照以下方式将编译器配置为在"选择性加入"模式下运行:

next.config.ts
TypeScript
import type { NextConfig } from 'next'
 
const nextConfig: NextConfig = {
  experimental: {
    reactCompiler: {
      compilationMode: 'annotation',
    },
  },
}
 
export default nextConfig

然后,你可以使用 React 的 "use memo" 指令来注解特定组件或 hooks 以选择加入:

app/page.tsx
TypeScript
export default function Page() {
  'use memo'
  // ...
}

注意: 你也可以使用 React 的 "use no memo" 指令来实现相反的效果,即选择让组件或 hook 退出优化。