# React Nativeのリストを8000倍速くした

By Tarik Pinarci (https://tarikpinarci.com). Published 2026-06-20. Canonical: https://tarikpinarci.com/ja/blog/improving-flatlist-performance-in-react-native

はい、読み間違いではありません。8000倍速くなりました。

とはいえ「アプリ全体が8000倍速くなったからヨットを買いに行こう」という意味の速さではありません。残念ながら。

それに、タイミングが面白いこともわかっています。

今はAIのニュースがものすごい速さで動く時代で、[Claude Fable 5がリリースされ、その数日後に提供停止になる](https://www.anthropic.com/news/claude-fable-5-mythos-5)ようなことまで起きています。みんながAGIっぽいモデルや輸出規制、プロジェクトを丸ごとこなすエージェントなど、そういったことについて議論しています。

そんな中で私は、React Nativeのリストを速くする話をしています。

この2つを並べると少し変に聞こえるのはわかります。

それでも私は、こういう仕事にワクワクします。「発明」と呼ぶのは大げさかもしれませんが、何千ものアプリで使われているフレームワークを改善するのは、私にとって意味のあることです。役に立つものがすべてSFのように見える必要はありません。ほとんどすべてのモバイルアプリが通る処理経路から、無駄な仕事を取り除くだけのこともあります。

今回の改善は、React Nativeのリストの中でもある特定のパスにあります。今どのセルが存在すべきかを決める、レンダーウィンドウの処理です。ベンチマークでは、古いパスは巨大なリストで数秒を無駄にすることがあり、新しいパスはそれを数ミリ秒にまで縮めます。

ふだん私たちはアプリ側にいます。`FlatList`や`SectionList`、ナビゲーション、アニメーション、状態管理ライブラリなど、いつものものを使っています。パフォーマンスに文句を言い、propsをいくつか試し、`memo`を足し、ひょっとしたら`getItemLayout`も足して、それで次に進みます。

でも本当の問題が、アプリのコードの一段下にあることもあります。

今回がまさにそうでした。

私は`react/react-native`にパフォーマンス改善を貢献し、[PR #57210](https://github.com/react/react-native/pull/57210)としてマージされました。この変更は、`VirtualizedList`が使うレンダーマスク作成パスから、不要なsticky headerの探索処理を取り除くものです。

<figure style="max-width:720px; margin:24px auto 30px;">
  <img
    src="/images/blog/react-native-merged-proof/flatlist-merged.jpg"
    alt="FlatListのパフォーマンス改善プルリクエストがReact Nativeにマージされたことを示すGitHubのタイムライン"
    style="width:100%; border-radius:14px; border:1px solid rgba(255,255,255,0.12);"
  />
  <figcaption style="margin-top:8px; text-align:center; font-size:0.9rem; color:#9ca3af;">React Nativeにマージされました。いまだに少し信じられません。</figcaption>
</figure>

普通の言葉で言うと、React Nativeはリストにsticky headerがひとつもないときでも、sticky headerを探していることがあったのです。

コンピューターあるあるです。

> リスト「sticky headerはひとつもないよ。」
>
> React Native「了解、じゃあ後ろ向きにスキャンして探してみるね。」

嬉しいのは、このパスが共有されていることです。そのため改善は次のすべてに効きます。

- `VirtualizedList`
- `FlatList`
- `VirtualizedSectionList`
- `SectionList`

そして、sticky headerをまったく使っていなくても、普通の`FlatList`の使い方で恩恵を受けられます。

### 実際に何が改善されるのか

コードに入る前に、これがどんな種類のパフォーマンスなのかを説明しておく価値があります。

改善されるのは、どの行を描画するかを決める前にReact Nativeが行うJavaScriptの処理です。

`FlatList`はレンダーウィンドウを保持しています。スクロールしたり、ジャンプしたり、初期インデックス付近でマウントしたり、大きなリストの中を移動したりするたびに、React Nativeはどのセルを描画し、どの部分をスペーサーのままにしておけるかを決める必要があります。

その判断は`VirtualizedList._createRenderMask`を通ります。

つまり、得られるものは次のとおりです。

- リストのウィンドウ更新時のJS処理が減る
- 巨大なリストの末尾付近にジャンプするときの処理が減る
- sticky headerのないリストで、不要なsticky headerのロジックが減る
- 画面に何を表示すべきかをリストが更新する前の判断が速くなる

普通のアプリの言葉で言えば、これは`FlatList`の中で「今どの行が存在すべきか」を決める部分を助けます。

非常に大きなリストでは、特にリストの末尾に近いところで、この小さな内部の判断が無視できないコストになることがあります。

そのコストを取り除くことで、レンダーウィンドウの更新パスがずっと安くなります。

### 気づいたこと

`FlatList`は、ほとんどすべてのReact Nativeアプリがどこかで使うコンポーネントのひとつです。

外から見るとシンプルです。

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

でも内部では`VirtualizedList`を通っています。

`VirtualizedList`はデータソース全体を描画するわけではありません。10万行あっても、勇敢だけれど負けが決まっている兵士のように10万行すべてを画面に並べたりはしません。レンダーウィンドウを保持し、レンダーマスクを使って、今どのセルが存在すべきかを決めます。

それは良いことです。

問題は、レンダーマスクを作るステップの中にありました。

React Nativeはsticky headerにも対応しています。sticky headerは特別で、そのアイテムが通常のビューポートの外にあっても、見た目上は上部に貼りついているので、描画されたままにしておく必要があります。

そのためReact Nativeには、次のようなロジックが必要です。

「ビューポートより前にある一番近いsticky headerを見つけて、描画したままにする。」

このロジック自体は正しいです。

困るのは、sticky headerがないときでもこの探索が走ることがあった点です。

### 以前のパス

この変更の前は、`VirtualizedList._createRenderMask`が`stickyHeaderIndices`からSetを作り、sticky header用のヘルパーを呼んでいました。

簡略化すると、次のような形でした。

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

そしてヘルパーは、最初に表示されるセルから後ろ向きにたどっていました。

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

小さなリストなら、どうということはありません。

でも非常に大きなリストでは、つらいことになります。100万行のリストの末尾付近にビューポートがあり、sticky headerがひとつもない場合でも、ヘルパーはリストのほぼ全体を後ろ向きにたどることがありました。

要するに、何もないものを見つけるために大がかりな探索をしているわけです。

私の好きな趣味ではありません。

![](https://media.giphy.com/media/FASybzL1ElrxpT2rTq/giphy.gif)

### FlatListが影響を受ける理由

この部分は見落としやすいです。

`VirtualizedList`を直接使う必要はありません。`FlatList`はその上に作られています。

つまり、次のようなコードでも、

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

やはり`VirtualizedList._createRenderMask`を通ります。

変更前は、`stickyHeaderIndices`のない普通のリストでも、sticky headerの探索コストを払うことがありました。

変更後は、sticky headerの処理をする前に、React Nativeがsticky headerが実際に存在するかを確認します。

とても高度な技術です。探す前に、そのものが存在するかを確認するのです。

### 変更内容

最初の部分は、sticky headerを使わない普通の`FlatList`にとって重要な部分です。

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

sticky headerがなければ、ヘルパーはスキップします。

2つ目の部分は、sticky headerがある場合も改善します。

アイテムのインデックスを後ろ向きにたどる代わりに、ヘルパーは設定されたsticky headerのインデックスをスキャンして、ビューポートより前にある一番近い有効なsticky headerを見つけます。

```js
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`があれば、インデックスがひとつずれます。

そのすべてが引き続き動く必要があります。

テストは次のようなケースをカバーしています。

- `stickyHeaderIndices`がない
- `stickyHeaderIndices`が空
- ソートされていないstickyインデックス
- 重複したstickyインデックス
- 負の値
- 小数の値
- ビューポートより後ろの値
- `ListHeaderComponent`によるオフセットの扱い

最後のものは重要です。sticky headerのインデックスは、内部の`ScrollView`の子要素のインデックスに基づいています。リストヘッダーがある場合、アイテムのインデックス`0`はもう子要素のインデックス`0`ではありません。

小さなoff-by-oneバグはこのあたりが大好きです。家賃も払わずに住みついています。

### ベンチマーク結果

`VirtualizedList._createRenderMask`のパスを、Fantom Hermesを使って直接ベンチマークしました。各ケース100サンプルです。

このベンチマークは、`VirtualizedList`の中のレンダーウィンドウの判断処理に焦点を当てています。

なので、すべてのアプリのすべての`FlatList`が急に8000倍速くスクロールするという意味ではありません。そうだったらいいのに。もしそうなら、私はとっくに鼻持ちならない人間になっています。

意味しているのは、このリストのウィンドウ処理という特定の内部パスが劇的に安くなったということです。そしてベンチマークが数秒の無駄な処理から数ミリ秒になるなら、それはやはり本物の勝利です。

### シミュレーターでの証拠

両方の実装をiOSシミュレーターで比較するために、小さなbare React Nativeアプリも作りました。

同じアプリ。同じ`1m`行の`FlatList`。同じ`no sticky headers`の構成。

違いは、インストールされている`VirtualizedList`の実装だけです。端末フレームの中に入っているのは静的なモックアップのスクリーンショットではなく、本物のシミュレーター録画です。動画のコントロールはあえて表示したままにしてあり、カーソルの波紋がベンチマークボタンのタップを示しています。

ベンチマークと挙動のテストは、マージされたReact NativeのPRにも入っています。

- [Fantomベンチマークテスト](https://github.com/react/react-native/blob/6b3a15b2c0eca3647e4648d4b68bcccd4336d42f/packages/react-native/Libraries/Lists/__tests__/VirtualizedList-stickyHeaders-benchmark-itest.js)
- [VirtualizedListの挙動テスト](https://github.com/react/react-native/blob/6b3a15b2c0eca3647e4648d4b68bcccd4336d42f/packages/virtualized-lists/Lists/__tests__/VirtualizedList-test.js)
- [マージされたPR #57210](https://github.com/react/react-native/pull/57210)

<div style="display:grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 36px; margin: 32px 0 42px; align-items:start; perspective:1400px;">
  <figure style="margin:0; transform:rotateY(10deg) rotateX(3deg); transform-style:preserve-3d;">
    <figcaption style="font-weight:700; color:#fca5a5; margin-bottom:14px; text-align:center;">変更前</figcaption>
    <div style="position:relative; max-width:330px; margin:0 auto; aspect-ratio:985/2008; filter:drop-shadow(32px 34px 46px rgba(0,0,0,0.58));">
    <div style="position:absolute; z-index:3; left:10%; top:5.5%; padding:5px 9px; border-radius:999px; background:rgba(0,0,0,0.68); border:1px solid rgba(255,255,255,0.16); color:#f8fafc; font-size:0.72rem; font-weight:700; pointer-events:none;">▶ シミュレーター動画</div>
    <video
      data-autoplay="viewport"
      autoplay
      controls
      playsinline
      muted
      loop
      preload="metadata"
      style="position:absolute; left:5.19%; top:2.17%; width:89.93%; height:95.66%; border-radius:8.8%/4.1%; object-fit:cover; background:#05080f;"
      src="/videos/blog/flatlist-performance/before-release-simplified.mp4"
    >
      お使いのブラウザはvideoタグに対応していません。
    </video>
    <div class="flatlist-video-cursor flatlist-video-cursor-before" aria-hidden="true"></div>
    <img
      src="/images/blog/device-frames/iphone-14-pro-black.png"
      alt=""
      loading="lazy"
      style="position:absolute; inset:0; width:100%; height:100%; pointer-events:none;"
    />
    </div>
  </figure>
  <figure style="margin:0; transform:rotateY(-10deg) rotateX(3deg); transform-style:preserve-3d;">
    <figcaption style="font-weight:700; color:#86efac; margin-bottom:14px; text-align:center;">変更後</figcaption>
    <div style="position:relative; max-width:330px; margin:0 auto; aspect-ratio:985/2008; filter:drop-shadow(-32px 34px 46px rgba(0,0,0,0.58));">
    <div style="position:absolute; z-index:3; left:10%; top:5.5%; padding:5px 9px; border-radius:999px; background:rgba(0,0,0,0.68); border:1px solid rgba(255,255,255,0.16); color:#f8fafc; font-size:0.72rem; font-weight:700; pointer-events:none;">▶ シミュレーター動画</div>
    <video
      data-autoplay="viewport"
      autoplay
      controls
      playsinline
      muted
      loop
      preload="metadata"
      style="position:absolute; left:5.19%; top:2.17%; width:89.93%; height:95.66%; border-radius:8.8%/4.1%; object-fit:cover; background:#05080f;"
      src="/videos/blog/flatlist-performance/after-release-simplified.mp4"
    >
      お使いのブラウザはvideoタグに対応していません。
    </video>
    <div class="flatlist-video-cursor flatlist-video-cursor-after" aria-hidden="true"></div>
    <img
      src="/images/blog/device-frames/iphone-14-pro-black.png"
      alt=""
      loading="lazy"
      style="position:absolute; inset:0; width:100%; height:100%; pointer-events:none;"
    />
    </div>
  </figure>
</div>

シミュレーターのデモでは、古いパスはリストのサイズに比例して増えていきます。レンダーウィンドウを1k回更新すると、次のようになります。

- `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秒未満なので、ミリ秒で表示しています。レンダーマスクを1,000回更新した場合は、1秒を超える値を秒で表示しています。

| ケース | 1回の更新(変更前) | 1回の更新(変更後) | 高速化 | 1,000回の更新(変更前) | 1,000回の更新(変更後) |
| --- | ---: | ---: | ---: | ---: | ---: |
| 10万行、sticky headerなし | 2.664 ms | 0.0034 ms | 780倍 | 2.66 s | 3.42 ms |
| 10万行、sticky headerが空 | 2.632 ms | 0.0033 ms | 800倍 | 2.63 s | 3.29 ms |
| 10万行、上部にsticky headerが1つ | 2.705 ms | 0.0054 ms | 499倍 | 2.71 s | 5.42 ms |
| 25万行、sticky headerなし | 6.543 ms | 0.0035 ms | 1,892倍 | 6.54 s | 3.46 ms |
| 25万行、sticky headerが空 | 6.579 ms | 0.0033 ms | 2,024倍 | 6.58 s | 3.25 ms |
| 25万行、上部にsticky headerが1つ | 6.796 ms | 0.0053 ms | 1,294倍 | 6.80 s | 5.25 ms |
| 50万行、sticky headerなし | 13.173 ms | 0.0033 ms | 4,002倍 | 13.17 s | 3.29 ms |
| 50万行、sticky headerが空 | 13.073 ms | 0.0033 ms | 3,997倍 | 13.07 s | 3.27 ms |
| 50万行、上部にsticky headerが1つ | 13.444 ms | 0.0054 ms | 2,511倍 | 13.44 s | 5.35 ms |
| 75万行、sticky headerなし | 19.524 ms | 0.0033 ms | 6,008倍 | 19.52 s | 3.25 ms |
| 75万行、sticky headerが空 | 19.572 ms | 0.0033 ms | 6,022倍 | 19.57 s | 3.25 ms |
| 75万行、上部にsticky headerが1つ | 20.304 ms | 0.0054 ms | 3,778倍 | 20.30 s | 5.37 ms |
| 100万行、sticky headerなし | 26.190 ms | 0.0033 ms | 8,058倍 | 26.19 s | 3.25 ms |
| 100万行、sticky headerが空 | 26.039 ms | 0.0033 ms | 8,012倍 | 26.04 s | 3.25 ms |
| 100万行、上部にsticky headerが1つ | 26.855 ms | 0.0053 ms | 5,075倍 | 26.86 s | 5.29 ms |

1,000回更新の列を見ると、違いが実感しやすくなります。

100万行の場合、sticky headerのない古いパスは、レンダーマスクを1,000回更新する間に、このヘルパーだけで約26秒を費やします。

変更後は、同じケースが約3.25 msです。

これは、React Nativeがどのセルを描画すべきかを決める前の共有リストパスから取り除かれた時間です。

### テスト計画

これを最高の意味で退屈なものにしたいと思っていました。挙動は同じで、仕事は少なく。

そのため、この貢献には挙動テストとベンチマークも含まれていました。

主なコマンドは次のとおりです。

```sh
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
```

```sh
yarn fantom packages/react-native/Libraries/Lists/__tests__/FlatList-itest.js packages/react-native/Libraries/Lists/__tests__/SectionList-itest.js --runInBand
```

```sh
yarn flow check
```

```sh
yarn fantom --benchmarks packages/react-native/Libraries/Lists/__tests__/VirtualizedList-stickyHeaders-benchmark-itest.js --runInBand
```

PRで変更したファイルは3つです。

- `VirtualizedList`の実装
- `VirtualizedList`に絞ったテスト
- sticky headerのレンダーマスクパス用のFantomベンチマーク

Metaのプロセスでインポートされ、`react/react-native`にマージされました。

### おわりに

この貢献で気に入っているのは、アプリ開発者が何もしなくていいことです。

新しいpropは不要です。

マイグレーションも不要です。

回避策も不要です。

アプリがsticky headerなしで大きな`FlatList`を使っているなら、React Nativeはそもそも不要だったsticky headerの探索処理を避けられるようになりました。

これは私が一番好きな種類のフレームワーク改善です。

変更範囲は小さく。ベンチマークは明確で。APIの変更はなし。

そしてよく使われるパスが、みんなにとって安くなります。

