React 源码揭秘:单节点 Diff 与 `reconcileSingleElement` 的复用判定逻辑
文档前端【免费下载链接】just-react「React技术揭秘」 一本自顶向下的React源码分析书项目地址https://gitcode.com/gh_mirrors/ju/just-react点击查看免费下载本篇技术指南聚焦「React 技术揭秘」just-react仓库中 docs/diff/one.md 讲解的核心主题——单一节点单元素的 Diff 算法即reconcileSingleElement如何判断新旧JSX对应的DOM 节点是否可以复用。文中将结合本仓库 docs/diff/prepare.md、docs/process/beginWork.md 等章节从调用入口、判定流程、删除语义到练习题完整梳理单节点 Diff 的源码实现与设计动机。读完本文你将能够徒手写出reconcileSingleElement的核心判定逻辑并准确解释key与type在节点复用中的各自作用。从reconcileChildFibers到reconcileSingleElement在 docs/diff/prepare.md 中我们了解到Diff 算法是Reconciler的核心对于update的组件beginWork会将其与该组件上次更新时对应的Fiber 节点即current fiber进行比较比较的结果生成新的Fiber 节点即workInProgress fiber。Diff 的入口函数是reconcileChildFibers它会根据newChild即本次更新的JSX 对象的类型分发到不同的处理函数function reconcileChildFibers( returnFiber: Fiber, currentFirstChild: Fiber | null, newChild: any, ): Fiber | null { const isObject typeof newChild object newChild ! null; if (isObject) { // object 类型可能是 REACT_ELEMENT_TYPE 或 REACT_PORTAL_TYPE switch (newChild.$$typeof) { case REACT_ELEMENT_TYPE: // 调用 reconcileSingleElement 处理 // ...其他 case } } if (typeof newChild string || typeof newChild number) { // 调用 reconcileSingleTextNode 处理 // ...省略 } if (isArray(newChild)) { // 调用 reconcileChildrenArray 处理多节点 Diff见 docs/diff/multi.md // ...省略 } // 以上都没有命中删除节点 return deleteRemainingChildren(returnFiber, currentFirstChild); }按照同级节点的数量Diff 被划分为两类单节点 DiffnewChild类型为object、number或string代表同级只有一个节点进入reconcileSingleElement/reconcileSingleTextNode多节点 DiffnewChild类型为Array同级有多个节点进入reconcileChildrenArray详见 docs/diff/multi.md。本文讨论的正是第一种情况以类型objectREACT_ELEMENT_TYPE为例它最终会进入reconcileSingleElement。reconcileSingleElement做了什么reconcileSingleElement是单节点 Diff 的核心函数它接收三个参数returnFiber当前正在执行beginWork的父级Fiber 节点currentFirstChild上一次更新中第一个子Fiber 节点单链表头element本次更新的ReactElement即JSX 对象。其完整执行流程可以概括为两步遍历上一次更新的兄弟 fiber 链寻找本次element能否复用的DOM 节点根据能否复用决定返回能复用则返回复用的fiber不能复用则删除旧节点并新建Fiber源码中创建新Fiber的部分省略。function reconcileSingleElement( returnFiber: Fiber, currentFirstChild: Fiber | null, element: ReactElement ): Fiber { const key element.key; let child currentFirstChild; // 首先判断是否存在对应 DOM 节点 while (child ! null) { // 上一次更新存在 DOM 节点接下来判断是否可复用 // 首先比较 key 是否相同 if (child.key key) { // key 相同接下来比较 type 是否相同 switch (child.tag) { // ...省略 case default: { if (child.elementType element.type) { // type 相同则表示可以复用 // 返回复用的 fiber return existing; } // type 不同则跳出 switch break; } } // 代码执行到这里代表key 相同但是 type 不同 // 将该 fiber 及其兄弟 fiber 标记为删除 deleteRemainingChildren(returnFiber, child); break; } else { // key 不同将该 fiber 标记为删除 deleteChild(returnFiber, child); } child child.sibling; } // 创建新 Fiber并返回 ...省略 }可以看到这个函数做的事情就是拿着本次更新的element遍历上一次更新的fiber单链表判断能否复用并在决定不复用时清理旧节点。React 预设的三个限制复用判定的前提在 docs/diff/prepare.md 中强调过React 为了把 Diff 的算法复杂度从 O(n³) 降下来预设了三条限制只对同级元素进行 Diff——节点跨越层级就不会尝试复用两个不同类型的元素会产生出不同的树——元素由div变为pReact 会销毁div及其子孙节点并新建p的树开发者可以通过key prop暗示哪些子元素在不同的渲染下能保持稳定。单节点 Diff 的代码正是这三条限制的直接体现从代码可以看出React 通过先判断key是否相同如果key相同则判断type是否相同只有key与type都相同时一个DOM 节点才能复用。删除语义的两个关键细节代码中有两处删除调用它们的语义差异值得细读当child ! null且key 相同且type 不同时执行deleteRemainingChildren(returnFiber, child)将child及其兄弟 fiber 全部标记删除当child ! null且key 不同时仅执行deleteChild(returnFiber, child)将child这一个 fiber 标记删除然后child child.sibling继续遍历。为什么会有这种差别考虑如下例子// 当前页面显示的 ul li * 3 // 这次需要更新的 ul p本次更新只有一个p属于单一节点的 Diff。在reconcileSingleElement中会遍历之前的 3 个fiber对应 DOM 为 3 个li寻找本次的p是否可以复用其中某个fiber的DOM。当key相同且type不同时代表已经找到了本次p对应的上次的fiber但p与li的type不同不能复用。既然唯一可能复用的候选已经排除了剩下的fiber就都没有机会了所以需要把child及其所有兄弟都标记删除deleteRemainingChildren。当key不同时只代表当前遍历到的这个fiber不能被p复用后面还有兄弟fiber尚未遍历到所以只标记当前这一个fiber删除deleteChild并继续向后遍历。一句话总结type不同意味着没希望了全删key不同只是这一个不行再看看下一个。从beginWork看 Diff 的触发时机单节点 Diff 并非凭空发生它由 render 阶段递过程中的beginWork驱动。在 docs/process/beginWork.md 中可以看到对于常见的FunctionComponent/ClassComponent/HostComponentbeginWork最终会进入reconcileChildrenexport function reconcileChildren( current: Fiber | null, workInProgress: Fiber, nextChildren: any, renderLanes: Lanes ) { if (current null) { // 对于 mount 的组件创建新的子 Fiber 节点 workInProgress.child mountChildFibers( workInProgress, null, nextChildren, renderLanes, ); } else { // 对于 update 的组件执行 Diff将比较的结果生成新 Fiber 节点 workInProgress.child reconcileChildFibers( workInProgress, current.child, nextChildren, renderLanes, ); } }也就是说Diff 只发生在updatecurrent ! null场景mount时走的是mountChildFibers直接创建全新的子Fiber 节点。reconcileChildFibers与mountChildFibers逻辑基本一致唯一区别是前者会为生成的Fiber 节点带上effectTag而后者不会。结合 docs/process/doubleBuffer.md 的双缓存机制可以更完整地理解current Fiber 树对应屏幕上已显示的内容workInProgress Fiber 树在内存中构建构建完成后通过切换current指针完成DOM更新。reconcileSingleElement返回的复用的 fiber正是workInProgress Fiber 树中的节点它通过alternate属性与current fiber相连。实战四道练习题巩固复用判定请判断如下JSX 对象对应的DOM 元素是否可以复用// 习题1 更新前 divka song/div // 更新后 pka song/p // 习题2 更新前 div keyxxxka song/div // 更新后 div keyoooka song/div // 习题3 更新前 div keyxxxka song/div // 更新后 p keyoooka song/p // 习题4 更新前 div keyxxxka song/div // 更新后 div keyxxxxiao bei/div公布答案习题1不能复用。未设置key prop时默认key null所以更新前后key相同都为null但更新前type为div、更新后为ptype改变则不能复用。习题2不能复用。更新前后key改变xxx→ooo不需要再判断type直接判定不能复用。习题3不能复用。更新前后key改变xxx→ooo不需要再判断type直接判定不能复用。注意本题type也变了但判定在key这一层就已经结束。习题4可以复用。更新前后key与type都未改变判定为可复用但children由ka song变为xiao bei复用的DOM 节点的子元素仍然需要更新。总结单节点 Diff 的判定口诀单节点 DiffreconcileSingleElement的核心逻辑可以浓缩为一句话先比key再比typekey不同逐个删key同type不同全删重建key、type都相同才复用。后续你可以继续阅读 docs/diff/multi.md 学习同级多个节点Array类型的 Diff那里会引入两轮遍历并用lastPlacedIndex与existingChildrenMap 来判断节点的移动是 Diff 算法中最精髓的部分。赞分享文档前端【免费下载链接】just-react「React技术揭秘」 一本自顶向下的React源码分析书项目地址https://gitcode.com/gh_mirrors/ju/just-react点击查看免费下载相关推荐React 多节点 Diff 深入解析两轮遍历与 lastPlacedIndex 移动判定just-react 源码分析React 多节点 Diff 深入解析两轮遍历与 lastPlacedIndex 移动判定just react 源码分析 本篇文章源自开源仓库《React文档前端戴森球计划终极工厂蓝图库3000设计方案快速建造高效星际工厂戴森球计划终极工厂蓝图库3000设计方案快速建造高效星际工厂 还在为戴森球计划中复杂的工厂设计而烦恼吗FactoryBluePrints蓝图库为你提供了完游戏开发react-native-reanimated v1 节点详解and 逻辑与节点的短路求值机制react native reanimated v1 节点详解 and 逻辑与节点的短路求值机制 导读 本文深入讲解 react native reanima移动开发前端上一篇WaveTools鸣潮工具箱完全指南三步实现120FPS高帧率与画质优化下一篇Hotkey DetectiveWindows系统热键占用检测的完整解决方案创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

智能体工程化落地:从评测、安全到业务集成的最佳实践

智能体工程化落地:从评测、安全到业务集成的最佳实践

1. 本周Trending观察:智能体不再是“玩具”,是“基建”这周我照例把GitHub Trending翻了几个来回,一个很直观的感受是:智能体(Agent)相关项目的热度还在涨,但涨法变了。半年前的榜单上&#xff…

2026/11/3 17:15:58 阅读更多 →
rsuite Progress 线条进度条尺寸定制:`strokeWidth` 与 `radius` 属性深度解析

rsuite Progress 线条进度条尺寸定制:`strokeWidth` 与 `radius` 属性深度解析

前端UI组件 【免费下载链接】rsuite 🧱 A suite of React components . 项目地址: https://gitcode.com/gh_mirrors/rs/rsuite 点击查看 免费下载 导读:本文以 rsuite 官方文档中 Progress 组件「尺寸(Size)」演示片…

2026/11/3 18:21:25 阅读更多 →
GSD 工作流校验策略全解:从 content-heuristic 到 human-review 的四级自动化门控

GSD 工作流校验策略全解:从 content-heuristic 到 human-review 的四级自动化门控

人工智能AI Agent代码智能体Agent 编排CLIAI 应用 【免费下载链接】gsd-2 A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture…

2026/10/28 13:27:02 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/12 5:00:00 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/12 5:13:20 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/12 5:13:20 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/11 17:16:37 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/11 17:16:37 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/12 5:13:20 阅读更多 →

日新闻

周新闻

月新闻