博客

我让 React Native 列表快了 8000 倍

2026年6月20日 9 分钟阅读

我合并进 React Native 的一个 PR,让 FlatList 和 VirtualizedList 的渲染窗口计算最多快了 8000 倍。

我让 React Native 列表快了 8000 倍
React NativeFlatListVirtualizedList性能开源

没错,你没看错:快了 8000 倍。

可惜,不是“你的整个 app 现在快了 8000 倍,赶紧去买游艇吧”那种快。

是的,我也知道这个时间点有点好笑。

我们正处在一个 AI 新闻飞速更新的时代,比如 Claude Fable 5 发布几天后就被暂停。大家在争论接近 AGI 的模型、出口管制、能独立完成整个项目的 agent,诸如此类。

而我在这里聊怎么让 React Native 列表变快。

把这两件事放在一起,听起来确实有点怪。我明白。

但我仍然觉得这类工作令人兴奋。也许“发明”这个词太大了,但改进一个被成千上万个 app 使用的框架,对我来说依然有意义。不是所有有用的东西都得看起来像科幻小说。有时候它只是把几乎每个移动 app 都会经过的一条路径上的无用功去掉。

这次的提升发生在 React Native 列表的一条特定路径上:render window 相关的计算,也就是决定此刻哪些 cell 应该存在的那部分工作。在那个 benchmark 里,旧路径在超大列表上可能白白浪费好几秒,新路径把它缩短到几毫秒。

大多数时候,我们站在 app 这一侧。我们用 FlatList、SectionList、导航、动画、状态管理库,以及所有常见的东西。我们抱怨性能,试几个 props,加上 memo,也许再加个 getItemLayout,然后继续过日子。

但有时候,真正的问题在 app 代码下面一层。

这次就是这样。

我给 react/react-native 贡献了一项性能改进,以 PR #57210 的形式合并。这个改动去掉了 VirtualizedList 在创建 render mask 时不必要的 sticky header 查找工作。

GitHub 时间线显示 FlatList 性能 PR 已合并进 React Native
已合并进 React Native。到现在还觉得有点不真实。

用大白话说:即使列表根本没有 sticky header,React Native 有时也会去查找 sticky header。

经典的计算机时刻。

列表:“我没有 sticky header。”

React Native:“好的,让我往回扫一遍找一个。”

好消息是,这条路径是共享的。所以这次改进影响到:

  • VirtualizedList
  • FlatList
  • VirtualizedSectionList
  • SectionList

而且是的,即使你完全不用 sticky header,普通的 FlatList 用法也能受益。

这到底改进了什么

在看代码之前,值得先说清楚这是哪一类性能。

改进发生在 React Native 决定渲染哪些行之前所做的 JavaScript 工作上。

FlatList 维护着一个 render window。当你滚动、跳转、在某个初始 index 附近挂载,或者在大列表里来回移动时,React Native 需要决定哪些 cell 应该被渲染,哪些部分可以保留为占位空白。

这个决定会经过 VirtualizedList._createRenderMask。

所以收益是:

  • 列表窗口更新时更少的 JS 工作
  • 跳到超大列表末尾附近时更少的工作
  • 没有 sticky header 的列表不再执行多余的 sticky header 逻辑
  • 在列表更新屏幕内容之前更快地做出决定

用 app 层面的话说,这改进的是 FlatList 里决定“此刻应该存在哪些行?”的那部分。

对于非常大的列表,尤其是靠近列表末尾时,这个小小的内部决定可能会变成真实的开销。

去掉这个开销后,render window 的更新路径便宜了很多。

我注意到的问题

FlatList 是几乎每个 React Native app 迟早都会用到的组件之一。

从外面看它很简单:

<FlatList data={items} renderItem={renderItem} />

但它底层走的是 VirtualizedList。

VirtualizedList 不会渲染整个数据源。如果你有 10 万行,它不会像一个勇敢但注定失败的士兵一样把 10 万行都放到屏幕上。它维护一个 render window,并用 render mask 来决定此刻应该存在哪些 cell。

这很好。

问题出在创建 render mask 的那一步。

React Native 也支持 sticky header。sticky header 比较特殊,因为 sticky 的那一项可能在正常视口之外,但它仍然需要保持渲染,因为从视觉上看它固定在顶部。

所以 React Native 需要这样的逻辑:

“找到视口之前最近的 sticky header,并保持它被渲染。”

这个逻辑是对的。

烦人的是,即使没有 sticky header,这个查找仍然可能执行。

旧的路径

在这次改动之前,VirtualizedList._createRenderMask 会根据 stickyHeaderIndices 构建一个 set,然后调用 sticky header 的辅助函数。

简化后的版本大概是这样:

const stickyIndicesSet = new Set(props.stickyHeaderIndices);
VirtualizedList._ensureClosestStickyHeader(
  props,
  stickyIndicesSet,
  renderMask,
  cellsAroundViewport.first,
);

然后这个辅助函数从第一个可见 cell 开始往回遍历:

for (let itemIdx = cellIdx - 1; itemIdx >= 0; itemIdx--) {
  if (stickyIndicesSet.has(itemIdx + stickyOffset)) {
    renderMask.addCells({first: itemIdx, last: itemIdx});
    break;
  }
}

对小列表来说,这无所谓。

对非常大的列表来说,就很痛苦了。如果视口靠近一个 100 万行列表的末尾,而且没有任何 sticky header,这个辅助函数仍然可能往回遍历几乎整个列表。

这基本上就是做了一次大搜索,结果什么也没找到。

这可不是我喜欢的爱好。

为什么 FlatList 也受影响

这一点很容易被忽略。

你不需要直接使用 VirtualizedList。FlatList 就是基于它构建的。

所以这样的代码:

<FlatList
  data={bigData}
  renderItem={renderItem}
/>

依然会经过 VirtualizedList._createRenderMask。

在改动之前,一个没有 stickyHeaderIndices 的普通列表,仍然可能要为 sticky header 查找付出代价。

改动之后,React Native 会先检查 sticky header 是否真的存在,再去做 sticky header 相关的工作。

非常先进的技术:先确认东西存在,再去找它。

改动内容

第一部分对普通的、不带 sticky 的 FlatList 用法最重要。

const stickyHeaderIndices = props.stickyHeaderIndices;
if (stickyHeaderIndices != null && stickyHeaderIndices.length > 0) {
  VirtualizedList._ensureClosestStickyHeader(
    props,
    stickyHeaderIndices,
    renderMask,
    cellsAroundViewport.first,
  );
}

如果没有 sticky header,我们就跳过这个辅助函数。

第二部分也改进了有 sticky header 的情况。

辅助函数不再按 item index 往回遍历,而是扫描配置好的 sticky header index,找出视口之前最近的有效 sticky header。

const stickyOffset = props.ListHeaderComponent ? 1 : 0;
const targetStickyIndex = cellIdx + stickyOffset;
let closestStickyIndex = null;

for (let itemIdx = 0; itemIdx < stickyHeaderIndices.length; itemIdx++) {
  const stickyIndex = stickyHeaderIndices[itemIdx];
  if (
    Number.isInteger(stickyIndex) &&
    stickyIndex < targetStickyIndex &&
    stickyIndex >= stickyOffset &&
    (closestStickyIndex == null || stickyIndex > closestStickyIndex)
  ) {
    closestStickyIndex = stickyIndex;
  }
}

if (closestStickyIndex != null) {
  const itemIdx = closestStickyIndex - stickyOffset;
  renderMask.addCells({first: itemIdx, last: itemIdx});
}

所以开销从:

“我们离列表开头有多远?”

变成了:

“配置了多少个 sticky header?”

这是一个好得多的问题。

保持行为不变

正是这一部分,让框架里的小改动没有看上去那么小。

你不能只是做优化,然后祈祷一切正常。stickyHeaderIndices 可能是无序的,可能包含重复值,也可能包含无效值。还可能有 ListHeaderComponent,它会让 index 偏移一位。

这些情况都仍然要正常工作。

测试覆盖了这些情况:

  • 没有 stickyHeaderIndices
  • stickyHeaderIndices 为空
  • sticky index 无序
  • sticky index 重复
  • 负数
  • 小数
  • 位于视口之后的值
  • ListHeaderComponent 偏移的处理

最后一个很重要。sticky header index 是基于底层 ScrollView 子元素的 index。当列表存在 header 时,item index 0 就不再是子元素 index 0 了。

小小的差一错误(off by one)特别喜欢这个地方。它们在这里白住不交房租。

Benchmark 结果

我用 Fantom Hermes 直接对 VirtualizedList._createRenderMask 这条路径做了 benchmark,每个用例采样 100 次。

这个 benchmark 关注的是 VirtualizedList 内部决定 render window 的工作。

所以,不,这并不意味着每个 app 里的每个 FlatList 突然滚动快了 8000 倍。我倒是希望如此。真那样的话,我早就得意得让人受不了了。

它的意思是,这条特定的内部列表窗口路径变得便宜了非常多。当 benchmark 从浪费好几秒变成只要几毫秒时,这依然是非常实在的收益。

模拟器实测

我还做了一个小的纯 React Native app,在 iOS Simulator 上对比两种实现。

同一个 app。同样是 1m 行的 FlatList。同样是 no sticky headers 的配置。

唯一的区别是安装的 VirtualizedList 实现。手机框里的是真实的模拟器录屏,不是静态的 mockup 截图。我特意保留了视频控件,光标脉冲标记的是点击 benchmark 按钮的时刻。

benchmark 和行为测试也都在已合并的 React Native PR 里:

优化前
▶ 模拟器视频
优化后
▶ 模拟器视频

在模拟器演示中,旧路径的耗时随列表大小增长。对于 1k 次 render window 更新,结果如下:

  • 50k rows:总计约 1.92 s(1.9196 ms / call)
  • 500k rows:总计约 18.78 s(18.78 ms / call)
  • 1m rows:总计约 38.40 s(38.40 ms / call)

使用优化后的路径,同样的演示基本保持平稳:

  • 50k rows:总计约 3.74 ms(0.0037 ms / call)
  • 500k rows:总计约 3.67 ms(0.0037 ms / call)
  • 1m rows:总计约 3.73 ms(0.0037 ms / call)

单次调用的数值都低于 1 秒,所以用毫秒表示。对于 1,000 次 render mask 更新,超过 1 秒的数值用秒表示。

用例优化前单次更新优化后单次更新提速优化前 1,000 次更新优化后 1,000 次更新
10 万行,无 sticky header2.664 ms0.0034 ms780x2.66 s3.42 ms
10 万行,sticky header 为空2.632 ms0.0033 ms800x2.63 s3.29 ms
10 万行,顶部一个 sticky header2.705 ms0.0054 ms499x2.71 s5.42 ms
25 万行,无 sticky header6.543 ms0.0035 ms1,892x6.54 s3.46 ms
25 万行,sticky header 为空6.579 ms0.0033 ms2,024x6.58 s3.25 ms
25 万行,顶部一个 sticky header6.796 ms0.0053 ms1,294x6.80 s5.25 ms
50 万行,无 sticky header13.173 ms0.0033 ms4,002x13.17 s3.29 ms
50 万行,sticky header 为空13.073 ms0.0033 ms3,997x13.07 s3.27 ms
50 万行,顶部一个 sticky header13.444 ms0.0054 ms2,511x13.44 s5.35 ms
75 万行,无 sticky header19.524 ms0.0033 ms6,008x19.52 s3.25 ms
75 万行,sticky header 为空19.572 ms0.0033 ms6,022x19.57 s3.25 ms
75 万行,顶部一个 sticky header20.304 ms0.0054 ms3,778x20.30 s5.37 ms
100 万行,无 sticky header26.190 ms0.0033 ms8,058x26.19 s3.25 ms
100 万行,sticky header 为空26.039 ms0.0033 ms8,012x26.04 s3.25 ms
100 万行,顶部一个 sticky header26.855 ms0.0053 ms5,075x26.86 s5.29 ms

1,000 次更新这一列让差距更容易感受到。

在 100 万行时,旧的无 sticky 路径在这个辅助函数里为 1,000 次 render mask 更新花掉大约 26 秒。

改动之后,同样的用例大约只要 3.25 ms。

这些时间是从一条共享的列表路径上省下来的,发生在 React Native 决定渲染哪些 cell 之前。

测试计划

我希望这个改动以最好的方式显得“无聊”:行为不变,工作更少。

所以这次贡献包含了行为测试和 benchmark 覆盖。

主要命令如下:

yarn jest packages/virtualized-lists/Lists/__tests__/VirtualizedList-test.js packages/virtualized-lists/Lists/__tests__/VirtualizedSectionList-test.js packages/react-native/Libraries/Lists/__tests__/FlatList-test.js --runInBand
yarn fantom packages/react-native/Libraries/Lists/__tests__/FlatList-itest.js packages/react-native/Libraries/Lists/__tests__/SectionList-itest.js --runInBand
yarn flow check
yarn fantom --benchmarks packages/react-native/Libraries/Lists/__tests__/VirtualizedList-stickyHeaders-benchmark-itest.js --runInBand

这个 PR 改动了三个文件:

  • VirtualizedList 的实现
  • 针对性的 VirtualizedList 测试
  • 针对 sticky header render mask 路径的 Fantom benchmark

它通过 Meta 的流程导入,并合并进了 react/react-native。

最后的想法

我喜欢这次贡献的一点是,app 开发者什么都不用做。

没有新的 prop。

没有迁移。

没有变通方案。

如果一个 app 使用了没有 sticky header 的大型 FlatList,React Native 现在可以避免那些本来就不必要的 sticky header 查找工作。

这是我最喜欢的一类框架改进。

改动面小。benchmark 清晰。没有 API 变更。

一条常用路径对所有人来说都变得更便宜了。