当前位置：首页 > React

react.lazy实现原理

2026-01-27 18:58:17React

React.lazy 的实现原理

React.lazy 是 React 提供的一种动态加载组件的方式，主要用于代码分割和懒加载。其核心原理基于动态导入（Dynamic Imports）和 Suspense 机制。

动态导入（Dynamic Imports）

React.lazy 依赖于 JavaScript 的动态导入语法（import()），这是一种返回 Promise 的语法。动态导入允许在运行时按需加载模块，而不是在初始加载时一次性加载所有代码。

const MyComponent = React.lazy(() => import('./MyComponent'));

动态导入的返回值是一个 Promise，解析后返回模块的默认导出（default export）。React.lazy 会等待这个 Promise 解析完成，然后渲染加载的组件。

Suspense 机制

React.lazy 必须与 React.Suspense 配合使用。Suspense 是一个组件，用于在懒加载组件加载过程中显示回退内容（如加载指示器）。

<Suspense fallback={<div>Loading...</div>}>
  <MyComponent />
</Suspense>

当懒加载组件尚未加载完成时，Suspense 会显示 fallback 内容。一旦组件加载完成，Suspense 会替换为实际的组件。

内部实现

React.lazy 的内部实现可以简化为以下逻辑：

包装动态导入：React.lazy 接收一个返回动态导入的函数，并将其包装为一个特殊的组件。
状态管理：懒加载组件内部维护加载状态（如 _status），记录当前是加载中、加载成功还是加载失败。
渲染处理：在渲染时，如果组件未加载完成，会抛出 Promise（Suspense 捕获并处理）；加载完成后渲染组件。

伪代码示例：

function lazy(load) {
  let status = 'pending'; // 加载状态
  let result; // 加载结果

  return function LazyComponent() {
    if (status === 'pending') {
      throw load().then(
        module => {
          status = 'success';
          result = module.default;
        },
        error => {
          status = 'error';
          result = error;
        }
      );
    }

    if (status === 'error') throw result; // 错误处理
    return result; // 返回加载的组件
  };
}

错误处理

如果动态导入失败（如网络问题），React.lazy 会抛出错误。可以通过 Error Boundary 捕获并处理这些错误。

class ErrorBoundary extends React.Component {
  state = { hasError: false };

  static getDerivedStateFromError(error) {
    return { hasError: true };
  }

  render() {
    if (this.state.hasError) {
      return <div>Error occurred!</div>;
    }
    return this.props.children;
  }
}