开源雷达 2026-11-07

来源:github · 原文链接:https://github.com/react/react · 整理:github_bot · 发布时间:2026-11-07


一、项目概览

React 于 2013 年 5 月在 GitHub 开源,采用 MIT 许可证,当前已积累 25.2 万+ Stars、5.1 万+ Forks,是前端领域事实上的 UI 基础设施之一。值得注意的是它的自我定位相当克制:“用于构建 Web 与原生用户界面的 JavaScript 库”——是库(library)而不是框架。它不规定路由、数据请求和状态管理,只负责一件事:把状态映射为界面。

官网 react.dev 提供从 Quick Start、井字棋教程到完整 API Reference 的文档体系,而且文档本身独立于代码仓库维护,是“文档即产品”的典型实践。

代码仓库是一个大型 monorepo:packages/ 承载全部 npm 发布包;compiler/ 是 React Compiler 的 Rust 实现(含 crates/、fixtures/);fixtures/ 集中存放并发、Fizz、Flight、SSR、View Transition 等行为验证场景;scripts/ 收纳 Rollup 构建、发布流程、错误码生成、ESLint 规则等工程脚本。仓库语言标注为 JavaScript,类型检查使用 Flow(见 flow-typed/ 与根目录 Flow 配置),测试主力是 Jest。

三条官方理念贯穿始终:声明式(为每个状态设计视图,由运行时负责高效更新)、组件化(组件自管状态,通过组合构建复杂 UI,状态不落在 DOM 上)、Learn Once, Write Anywhere(不对技术栈其余部分做假设,同一范式可延伸到服务端与原生)。

二、核心特性速览

特性具体表现工程价值
声明式渲染描述“界面在此状态下长什么样”,更新由运行时完成代码可预测,调试时关注状态而非 DOM 操作序列
组件化组件封装自身状态,逻辑与视图同处 JS复用粒度细,状态与宿主解耦
跨端复用同一组件心智可渲染到 Web、原生、测试等宿主技能可迁移,显著降低多端成本
JSX类 HTML 语法糖,编译为函数调用结构直观可读,且非强制依赖

一个最小可运行示例如下,它同时体现了组件、Hooks 与新的根 API:

import { useState } from 'react';
import { createRoot } from 'react-dom/client';

function Counter({ step = 1 }) {
  const [count, setCount] = useState(0);
  return (
    <button onClick={() => setCount((c) => c + step)}>
      clicked {count} times
    </button>
  );
}

createRoot(document.getElementById('root')).render(<Counter step={2} />);

三、系统架构设计

React 系统架构

React 的架构可以理解为三层:交互与接口层、核心协调层、渲染与支撑层。

交互与接口层由“应用界面(JSX Components)”和“React API(Hooks / JSX)”构成,是开发者直接接触的面。react 包本身很薄:它导出 createElement、Hooks、Suspense、memo、lazy 与 JSX runtime,却几乎不含“如何把结果画到屏幕上”的逻辑。界面产生的渲染请求与 API 调用,统一向下交给协调引擎。

核心协调层是 React 最关键的部分。Fiber Reconciler 负责 diff、构建与复用 Fiber 树、维护 Lanes 优先级、收集副作用;Scheduler 作为横向支撑,把时间切片与优先级队列从协调逻辑中剥离,让“任务调度”成为可独立演进的模块。协调器与具体宿主之间靠 host config 解耦——渲染器注入 createInstance、appendChild、commitUpdate 等宿主方法,协调器只调用抽象接口。Error Boundary 同样在此层参与:渲染期抛错被捕获后转为降级渲染,避免整棵树崩溃。

渲染与支撑层承接落地工作:DOM Bindings 把 Fiber 变更翻译为真实 DOM 操作,读取 State / Props 决定输出,最终把变更提交到 Browser / Native 宿主;React Native 走同一套协调逻辑,只替换宿主实现。

这套分层的关键收益是一份协调逻辑、多个渲染器:仓库中存在 react-dom、react-native-renderer、react-noop-renderer、react-test-renderer、react-art、react-markup 等不同目标实现,它们共享 reconciler,仅在宿主配置上分道扬镳。也正因如此,React 才能同时支撑浏览器、移动端、测试环境与服务端渲染。

四、核心流程或主循环

React 更新主循环

以一次 setState 为例,更新主循环可分为六个站点:

  1. 触发更新(setState):事件回调或异步结果调用 setter,React 计算 lane 优先级,把更新挂到对应 Fiber 的 update 队列,并标记根节点有待处理工作。
  2. 调度任务(Scheduler):根节点被调度后,Scheduler 依据优先级决定立即执行还是推入延时队列;并发模式下,渲染工作可被更高优先级任务打断并稍后重放。
  3. 渲染阶段(Render Phase):beginWork 自顶向下、completeWork 自底向上,构建 workInProgress 树。这是可中断的部分,也是纯计算——不触碰宿主环境。
  4. 协调比对(Reconcile):对新旧子节点按 key 与 type 比对,决定复用、插入、移动或删除,产出 Placement / Update / Deletion 等副作用标记。
  5. 提交阶段(Commit Phase):不可中断。先 beforeMutation(如 getSnapshotBeforeUpdate),再 mutation 把变更批量写入宿主,最后 layout 阶段同步执行 useLayoutEffect 与 ref 回调。
  6. 副作用清理(Effects):提交完成后异步调度 passive effects,执行 useEffect 的清理与回调;随后检查是否仍有剩余 lane,有则回写进入下一轮。 整个循环的中枢是 Fiber 树与优先级(Fiber & Lanes):Fiber 既是工作单元也是状态容器,Lanes 用位掩码表达优先级与批次,二者共同回答“先渲染什么、能渲染多久、何时必须让出主线程”。

五、核心模块解析

模块职责
reactAPI 入口:createElement、Hooks、Suspense、memo、lazy 与 JSX runtime
react-reconcilerFiber 实现、Lanes 优先级、diff、副作用收集与提交编排
scheduler独立调度器,优先级队列与时间切片
react-domWeb 渲染器入口:createRoot、hydrateRoot、事件系统装配
react-dom-bindingsDOM 宿主配置、属性与事件名映射,差异化逻辑的真正落点
shared跨包共享常量、Symbol 与工具函数,防止语义漂移
react-server-dom-*Server Components / Flight 协议的 bundler 适配(webpack、turbopack、parcel、esm、unbundled)
react-devtools*组件树与 Profiler 调试,覆盖扩展、内联、Fusebox 等多种形态
eslint-plugin-react-hooksHooks 调用规则与依赖数组的静态检查
compiler/React Compiler:Rust 实现的自动 memo 化编译器与 Babel 插件

此外,react-is、react-refresh、use-sync-external-store、react-cache 等小而关键的包,分别承担类型判断、热更新、外部状态订阅与实验性缓存职责,构成主干之外的配套零件。

六、特色能力

并发渲染是近年最重要的架构演进:渲染可中断、可丢弃、可重放,配合 useTransition、useDeferredValue,让输入等高优交互不被大列表渲染阻塞。代价是渲染函数必须保持纯净,副作用不能随意散落。

Suspense 与 Server Components 把“等待”变成声明式的一等公民,并把部分组件渲染搬回服务端,客户端只接收可序列化的 Flight 载荷,从而显著压缩 bundle。仓库中 react-client、react-server、react-server-dom-* 与 fixtures/flight* 构成完整证据链。

React Compiler 试图把 memo 化从手写 useMemo/useCallback 交给构建期自动完成。值得注意的是它用 Rust 重写(compiler/crates)并通过 Babel 插件接入,属于构建期优化而非运行时魔法——这也意味着它不会替不遵守规则的代码兜底。

React Native 的价值不在“把 DOM 搬到手机”,而在复用组件与状态的心智模型,替换的只是宿主层。除此之外,View Transition 集成、useSyncExternalStore 对接外部状态库等细节能力,也在持续补齐体验短板。

七、工具链与生态

DevTools 提供组件树、props/state 检视与 Profiler 火焰图,并有扩展、内联、Fusebox 等多种落地形态;eslint-plugin-react-hooks 通过静态规则强行约束 Hook 调用顺序与依赖数组,是团队协作的质量底线——fixtures/ 中从 eslint v6 到 v10 的并存,说明其向后兼容是认真的;React Refresh 提供保留状态的组件级热更新;Server DOM 同时适配 webpack、turbopack、parcel、ESM 与无打包场景,刻意不绑定单一构建工具。发布侧由 ReactVersions.js 与 scripts/release 支撑 stable / experimental / canary 多通道。上层则由 Next.js、Remix、Expo 等框架把 React 当作运行时底座。

八、部署与安全

React 以多包形式通过 npm 发布,版本与通道由发布脚本统一管理。服务端能力上,react-dom/server 同时提供字符串渲染与流式渲染(renderToPipeableStream / renderToReadableStream),配合 Suspense 实现渐进式吐出 HTML。

安全方面,React 的基础防线是默认转义:JSX 中插入的文本与属性值会被转义,天然降低 XSS 风险。需要警惕的是显式开口:dangerouslySetInnerHTML 从命名上就是警告,使用前必须做 HTML 净化;href/src 中的 javascript: 等协议需在应用层校验;RSC 场景下不要把敏感数据放进会被序列化下发的 Flight 载荷。React 提供的是安全默认值,不是安全保证。

九、适用场景

适合:中大型单页应用与设计系统;需要 SSR / 流式渲染的全栈应用;以 React Native 覆盖移动端的多端团队;以及渐进式接入——在既有页面里渲染单个组件,用多少接多少,这正是它“为渐进采用而设计”的初衷。相对不适合:内容为主的静态站点(纯静态生成更轻)、以及体积极度敏感的小型页面。

十、总结评价

React 的真正价值不在于 API 数量,而在于把“UI = f(state)”变成了可工程化的运行时契约:协调器 + Lanes + host config 三层抽象,使它能用一套逻辑供养浏览器、原生与服务端;并发渲染与编译器是这条主线的自然延伸,而非临时补丁。它适合需要长期维护、多人协作、多端复用的团队;但对小项目而言,其抽象成本与心智负担并不划算。局限同样真实:并发模型与 Hooks 规则带来实打实的学习曲线;RSC 的 bundler 适配成熟度仍不齐;作为“库”的克制意味着路由与数据层必须自行选型,架构决策成本转嫁给了团队。结论是:它值得作为长期 UI 基础设施投入,但要清楚自己是在为“规模与演进”付费。

参考链接:React 仓库 · 官方文档 react.dev