React 源码揭秘:单节点 Diff 与 `reconcileSingleElement` 的复用判定逻辑

发布时间:2026/10/8 14:10:58

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),仅供参考
延伸阅读

更多相关文章

2026/10/8 14:10:58

openrig:终端AI编程助手统一编排与多模型接入实战

1. 从零认识 openrig:它到底解决什么问题第一次看到 openrig 这个名字,很多人会以为是某个硬件支架项目,毕竟 rig 在英文里有“装配、支架”的意思。但如果你最近在折腾 Claude Code、Codex 这类终端 AI 编程助手,就会明白它出现的…

2026/10/8 14:05:58

t3code 多引擎 AI 编程整合:Electron 桌面客户端与本地代理实践

1. 从 t3code 这个标题说起:它到底想解决什么问题第一次看到 “t3code” 这个标题,我脑子里蹦出来的第一个念头是:这大概率又是一个围绕 AI 编程助手做整合的工具。为什么这么判断?因为把标题和它周围那一圈热搜词放在一起看&…

2026/10/8 15:06:21

Trae切换GitHub账号完整指南:从授权清理到Git身份配置

你可能也遇到过这种情况:在Trae里一直用A账号克隆、提交、推送,换到新电脑后想切回B账号,点了半天的设置都没找到入口;或者想把公司的私有仓库和个人开源项目分开管理,结果Trae的AI聊天、代码补全都在用同一个身份&…

2026/10/8 15:06:21

Claude Code AI编程Agent入门到进阶:安装、模型接入与高效使用

做技术写作这些年,我换过不少工具,但Claude Code确实是我最近用下来最上头的一个。它不是那种装完就吃灰的IDE插件,而是一个真正能自己读代码、改文件、跑命令、看报错循环修复的编程Agent。很多人把它当成普通对话式AI编程助手在用&#xff…

2026/10/8 15:06:21

三极管原理与电路设计实战:从电流放大到MOS管选型

1. 从电流放大本质说起:三极管为什么能"以小控大"很多人在刚接触三极管的时候,第一反应是把它当成一个"电子开关"来用——给基极加个高电平,集电极和发射极就通了;不给信号,就断开。这个理解用于开…

2026/10/8 15:06:21

Java WebSocket实战:从API到Spring Boot心跳与重连

刚接触Java WebSocket那会儿,我其实是被一个在线客服项目逼的。用户在前端点“开始咨询”,后端必须立刻把消息推过去,延迟稍微高点,页面的加载状态就尴尬得没边。我一开始图省事,用HTTP轮询撑了两周,数据库…

2026/10/8 15:06:21

XVF3800四麦语音前端方案设计与调试实战

做会议音视频方案这几年,每次接触新主控芯片,我都习惯先翻它的手册看三件事:麦克风输入通道、DSP处理链路、外部接口的灵活度。XMOS这颗XVF3800,说实在的,单看型号就有种熟悉感——XMOS的命名规律向来直接,…

2026/10/8 15:01:20

Tessent PDL实战:DFT测试流程与MBIST/SSN应用

任何一个用Tessent做过DFT项目的工程师,大概都有这样的经历:打开Tessent的文档,最先记住的是MBIST、SSN、Scan这些大块头关键词,可真正到了生成测试向量、调试覆盖率的阶段,几乎所有流程都会回到同一个载体——PDL。PD…

2026/10/8 10:03:18

Jev+Agent接管浏览器:browser-use实战与jev-ultrafast性能优化

1. 从“Jev”说起:为什么我要把Agent接进浏览器“Jev”这个词最近在圈子里出现的频率越来越高,很多人第一次听到会以为是某个新模型的名字,其实它更像是一种思路——把Jev模型的能力当作底座,通过Agent的方式去接管浏览器&#xf…

2026/10/8 10:03:20

多智能体集群实战:DeepAgents编排、MCP与A2A协议及Skills体系

1. 从"单兵作战"到"集群协同":多智能体编排到底在解决什么问题如果你最近在折腾 Agent 相关的东西,大概率会有一种感觉:单个 Agent 能做的事情,其实很快就摸到天花板了。你给它一个提示词,挂几个工…

2026/10/8 6:05:44

无源低通滤波器设计实战:从RC到LC,手把手教你避开那些坑

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/8 0:02:17

自然数立方等于连续奇数之和:从证明到编程验证

十几年来我一直游走在数学科普和编程教学这两块内容之间,对“看起来像魔法、拆开全是数学”的结论总是格外敏感。最近翻资料时又撞见一句话:任何一个自然数 m 的立方,都可以写成 m 个连续奇数之和。2 的立方等于 3 加 5,3 的立方等…

2026/10/8 0:02:17

C#上位机SSH连接实战:用SSH.NET补齐超时、批量与密钥认证

简介:这是一份基于 C# 开发的 SSH 连接功能半成品工程,原本作为另一个主项目的子功能模块,现独立打包分享。工程采用 WinForms 界面,包含源码、解决方案、安装部署工程、NuGet 依赖包及说明文档,适合正在做远程连接、网…

2026/10/8 0:02:17

Java SpringBoot一体化智能售后系统设计与实现全解析

毕业设计年年做,Java Web 方向的题目翻来覆去就那么几个,但“一体化智能售后系统”这个题,每次看到我都觉得值得认真聊一聊。它不是一个简单 curd 堆出来的管理系统,而是把客户、工单、派单、处理、回访、统计整条链路串起来的一套…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑