Blog

Tôi đã làm list trong React Native nhanh hơn 8000 lần

20 tháng 6, 2026 9 phút đọc

PR đã được merge của tôi vào React Native giúp phần việc render window của FlatList và VirtualizedList nhanh hơn tới 8000 lần.

Tôi đã làm list trong React Native nhanh hơn 8000 lần
React NativeFlatListVirtualizedListHiệu năngMã nguồn mở

Đúng vậy, bạn không đọc nhầm đâu: nhanh hơn 8000 lần.

Không phải kiểu "cả app của bạn giờ nhanh hơn 8000 lần, đi mua du thuyền đi" đâu. Tiếc thật.

Và đúng, tôi biết thời điểm này hơi buồn cười.

Chúng ta đang sống trong thời đại mà tin tức AI đi nhanh đến mức một thứ như Claude Fable 5 có thể ra mắt rồi bị tạm ngưng chỉ vài ngày sau. Mọi người tranh cãi về các model gần với AGI, kiểm soát xuất khẩu, agent làm trọn cả dự án, đủ thứ.

Còn tôi thì ở đây nói chuyện làm list trong React Native chạy nhanh hơn.

Đặt hai chuyện đó cạnh nhau thì nghe hơi lạ. Tôi hiểu.

Nhưng tôi vẫn thấy kiểu công việc này rất thú vị. Có thể "phát minh" là từ quá lớn, nhưng cải thiện một framework mà hàng nghìn app đang dùng vẫn có ý nghĩa với tôi. Không phải thứ hữu ích nào cũng phải trông như khoa học viễn tưởng. Đôi khi nó chỉ là bỏ đi phần việc thừa trong một luồng mà gần như app mobile nào cũng đi qua.

Cái lợi nằm trong một luồng cụ thể của list trong React Native: phần việc tính render window, quyết định những cell nào nên tồn tại ngay lúc này. Trong benchmark đó, luồng cũ có thể lãng phí vài giây với list cực lớn, còn luồng mới giảm xuống chỉ còn vài mili giây.

Phần lớn thời gian chúng ta ở phía app. Chúng ta dùng FlatList, SectionList, navigation, animation, các thư viện state và mấy thứ quen thuộc khác. Chúng ta than phiền về hiệu năng, thử vài props, thêm memo, có thể thêm getItemLayout, rồi sống tiếp.

Nhưng đôi khi vấn đề thật sự nằm ở tầng ngay bên dưới code của app.

Đó là chuyện đã xảy ra ở đây.

Tôi đã đóng góp một cải tiến hiệu năng cho react/react-native, được merge dưới dạng PR #57210. Thay đổi này bỏ đi phần tra cứu sticky header không cần thiết trong luồng tạo render mask mà VirtualizedList sử dụng.

Dòng thời gian trên GitHub cho thấy pull request cải thiện hiệu năng FlatList đã được merge vào React Native
Đã được merge vào React Native. Đến giờ vẫn thấy hơi khó tin.

Nói đơn giản: React Native đôi khi vẫn đi kiểm tra sticky header ngay cả khi list không có sticky header nào.

Đúng kiểu máy tính.

List: "Tôi không có sticky header nào cả."

React Native: "Ok, để tôi quét ngược lại tìm một cái."

Điểm hay là luồng này được dùng chung. Vì vậy cải tiến này ảnh hưởng đến:

  • VirtualizedList
  • FlatList
  • VirtualizedSectionList
  • SectionList

Và đúng, cách dùng FlatList thông thường cũng được hưởng lợi, kể cả khi bạn hoàn toàn không dùng sticky header.

Cải tiến này thực sự giúp được gì

Trước khi đi vào code, nên nói rõ đây là loại hiệu năng nào.

Cải tiến nằm ở phần việc JavaScript mà React Native làm trước khi quyết định những dòng nào cần được render.

FlatList giữ một render window. Khi bạn cuộn, nhảy đến một vị trí, mount gần một initial index, hay di chuyển trong một list lớn, React Native cần quyết định cell nào cần render và phần nào có thể để là khoảng trống (spacer).

Quyết định đó đi qua VirtualizedList._createRenderMask.

Vậy cái lợi là:

  • ít việc JS hơn khi cập nhật window của list
  • ít việc hơn khi nhảy đến gần cuối một list cực lớn
  • bớt logic sticky header không cần thiết cho các list không có sticky header
  • ra quyết định nhanh hơn trước khi list cập nhật những gì hiển thị trên màn hình

Nói theo góc nhìn app thông thường, cải tiến này giúp phần của FlatList trả lời câu hỏi "những dòng nào nên tồn tại ngay lúc này?"

Với list rất lớn, đặc biệt khi ở gần cuối list, quyết định nội bộ nhỏ đó có thể trở thành một chi phí thật sự.

Bỏ được chi phí đó thì luồng cập nhật render window rẻ hơn rất nhiều.

Điều tôi để ý thấy

FlatList là một trong những component mà gần như app React Native nào cũng dùng đến ở một lúc nào đó.

Nhìn từ bên ngoài thì nó có vẻ đơn giản:

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

Nhưng bên dưới, nó đi qua VirtualizedList.

VirtualizedList không render toàn bộ data source. Nếu bạn có 100k dòng, nó không đặt cả 100k dòng lên màn hình như một người lính dũng cảm nhưng chắc chắn sẽ thua. Nó giữ một render window và dùng render mask để quyết định những cell nào nên tồn tại ngay lúc này.

Điều đó tốt.

Vấn đề nằm trong bước tạo render mask.

React Native cũng hỗ trợ sticky header. Sticky header đặc biệt vì item dính đó có thể nằm ngoài viewport bình thường, nhưng vẫn phải được render vì về mặt hiển thị nó đang dính ở trên cùng.

Nên React Native cần một logic kiểu như:

"Tìm sticky header gần nhất trước viewport và giữ cho nó được render."

Logic đó đúng.

Phần khó chịu là việc tra cứu đó vẫn có thể chạy khi không có sticky header nào.

Luồng cũ

Trước thay đổi này, VirtualizedList._createRenderMask tạo một set từ stickyHeaderIndices rồi gọi helper xử lý sticky header.

Phiên bản rút gọn trông như sau:

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

Sau đó helper đi ngược từ cell hiển thị đầu tiên:

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

Với list nhỏ thì chẳng sao.

Với list rất lớn thì nó trở nên tệ. Nếu viewport ở gần cuối một list 1 triệu dòng, và không có sticky header nào, helper vẫn có thể đi ngược qua gần như cả list.

Về cơ bản là làm một cuộc tìm kiếm lớn để tìm ra... không có gì.

Không phải sở thích yêu thích của tôi.

Vì sao FlatList bị ảnh hưởng

Phần này rất dễ bị bỏ qua.

Bạn không cần dùng trực tiếp VirtualizedList. FlatList được xây dựng trên nó.

Nên đoạn code kiểu này:

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

vẫn đi qua VirtualizedList._createRenderMask.

Trước thay đổi, một list bình thường không có stickyHeaderIndices vẫn có thể phải trả giá cho việc tra cứu sticky header.

Sau thay đổi, React Native kiểm tra xem sticky header có thật sự tồn tại không trước khi làm bất cứ việc gì liên quan đến sticky header.

Công nghệ rất cao cấp: kiểm tra xem thứ đó có tồn tại không trước khi đi tìm nó.

Thay đổi

Phần đầu tiên là phần quan trọng với cách dùng FlatList thông thường không có sticky header.

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

Nếu không có sticky header, chúng ta bỏ qua helper.

Phần thứ hai cũng cải thiện cả trường hợp có sticky header.

Thay vì đi ngược qua các index của item, helper quét các sticky header index đã được cấu hình và tìm sticky header hợp lệ gần nhất trước viewport.

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});
}

Vậy chi phí đổi từ:

"Chúng ta đang cách đầu list bao xa?"

thành:

"Có bao nhiêu sticky header được cấu hình?"

Đó là một câu hỏi tốt hơn nhiều.

Giữ nguyên hành vi

Đây là phần khiến những thay đổi nhỏ trong framework không nhỏ như vẻ ngoài.

Bạn không thể chỉ tối ưu rồi hy vọng mọi thứ vẫn ổn. stickyHeaderIndices có thể chưa được sắp xếp. Nó có thể chứa giá trị trùng lặp. Nó có thể chứa giá trị không hợp lệ. Có thể có ListHeaderComponent, làm index bị lệch đi một.

Tất cả những trường hợp đó vẫn phải chạy đúng.

Test bao phủ các trường hợp như:

  • không có stickyHeaderIndices
  • stickyHeaderIndices rỗng
  • sticky index chưa được sắp xếp
  • sticky index bị trùng
  • giá trị âm
  • giá trị thập phân
  • giá trị nằm sau viewport
  • xử lý độ lệch do ListHeaderComponent

Trường hợp cuối rất quan trọng. Sticky header index dựa trên index của các child bên trong ScrollView. Khi có list header, item index 0 không còn là child index 0 nữa.

Bug lệch một đơn vị (off-by-one) rất thích khu vực này. Chúng sống ở đó miễn phí.

Kết quả benchmark

Tôi benchmark trực tiếp luồng VirtualizedList._createRenderMask bằng Fantom Hermes, với 100 mẫu cho mỗi trường hợp.

Benchmark này tập trung vào phần việc quyết định render window bên trong VirtualizedList.

Nên không, điều này không có nghĩa là mọi FlatList trong mọi app bỗng nhiên cuộn nhanh hơn 8000 lần. Ước gì được vậy. Nếu thế thì tôi đã khoe đến mức không ai chịu nổi rồi.

Nó có nghĩa là luồng list windowing nội bộ cụ thể này đã rẻ hơn rất nhiều. Và khi benchmark đi từ vài giây lãng phí xuống còn vài mili giây, đó vẫn là một cải thiện rất thật.

Bằng chứng trên simulator

Tôi cũng làm một app React Native bare nhỏ để so sánh hai cách triển khai trên iOS Simulator.

Cùng một app. Cùng một FlatList 1m dòng. Cùng thiết lập no sticky headers.

Khác biệt duy nhất là phiên bản VirtualizedList được cài. Đây là các bản quay simulator thật bên trong khung điện thoại, không phải ảnh mockup tĩnh. Tôi cố ý để hiện thanh điều khiển video, và hiệu ứng nhấp nháy của con trỏ đánh dấu lúc bấm nút benchmark.

Benchmark và các test hành vi cũng nằm trong PR React Native đã được merge:

Trước
▶ video simulator
Sau
▶ video simulator

Trong bản demo trên simulator, luồng cũ tăng theo kích thước list. Với 1k lần cập nhật render window, kết quả như sau:

  • 50k rows: tổng cộng khoảng 1.92 s (1.9196 ms / call)
  • 500k rows: tổng cộng khoảng 18.78 s (18.78 ms / call)
  • 1m rows: tổng cộng khoảng 38.40 s (38.40 ms / call)

Với luồng đã tối ưu, cùng bản demo đó gần như không đổi:

  • 50k rows: tổng cộng khoảng 3.74 ms (0.0037 ms / call)
  • 500k rows: tổng cộng khoảng 3.67 ms (0.0037 ms / call)
  • 1m rows: tổng cộng khoảng 3.73 ms (0.0037 ms / call)

Giá trị cho mỗi lần gọi đều dưới 1 giây, nên được ghi bằng mili giây. Với 1.000 lần cập nhật render mask, các giá trị trên 1 giây được ghi bằng giây.

Trường hợpMột lần cập nhật, trướcMột lần cập nhật, sauTăng tốc1.000 lần cập nhật, trước1.000 lần cập nhật, sau
100k dòng, không có sticky header2.664 ms0.0034 ms780x2.66 s3.42 ms
100k dòng, sticky header rỗng2.632 ms0.0033 ms800x2.63 s3.29 ms
100k dòng, một sticky header ở đầu2.705 ms0.0054 ms499x2.71 s5.42 ms
250k dòng, không có sticky header6.543 ms0.0035 ms1,892x6.54 s3.46 ms
250k dòng, sticky header rỗng6.579 ms0.0033 ms2,024x6.58 s3.25 ms
250k dòng, một sticky header ở đầu6.796 ms0.0053 ms1,294x6.80 s5.25 ms
500k dòng, không có sticky header13.173 ms0.0033 ms4,002x13.17 s3.29 ms
500k dòng, sticky header rỗng13.073 ms0.0033 ms3,997x13.07 s3.27 ms
500k dòng, một sticky header ở đầu13.444 ms0.0054 ms2,511x13.44 s5.35 ms
750k dòng, không có sticky header19.524 ms0.0033 ms6,008x19.52 s3.25 ms
750k dòng, sticky header rỗng19.572 ms0.0033 ms6,022x19.57 s3.25 ms
750k dòng, một sticky header ở đầu20.304 ms0.0054 ms3,778x20.30 s5.37 ms
1m dòng, không có sticky header26.190 ms0.0033 ms8,058x26.19 s3.25 ms
1m dòng, sticky header rỗng26.039 ms0.0033 ms8,012x26.04 s3.25 ms
1m dòng, một sticky header ở đầu26.855 ms0.0053 ms5,075x26.86 s5.29 ms

Cột 1.000 lần cập nhật giúp cảm nhận sự khác biệt dễ hơn.

Ở 1 triệu dòng, luồng cũ không có sticky header tốn khoảng 26 giây trong helper này cho 1.000 lần cập nhật render mask.

Sau thay đổi, cùng trường hợp đó chỉ còn khoảng 3.25 ms.

Đó là thời gian được bỏ đi khỏi một luồng list dùng chung, trước khi React Native quyết định những cell nào cần được render.

Kế hoạch test

Tôi muốn thay đổi này nhàm chán theo nghĩa tốt nhất: cùng hành vi, ít việc hơn.

Nên phần đóng góp có cả test hành vi và benchmark.

Các lệnh chính là:

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 thay đổi ba file:

  • phần triển khai VirtualizedList
  • các test tập trung cho VirtualizedList
  • một benchmark Fantom cho luồng render mask có sticky header

Nó được import qua quy trình của Meta và merge vào react/react-native.

Suy nghĩ cuối cùng

Điều tôi thích ở đóng góp này là lập trình viên app không cần làm gì cả.

Không có prop mới.

Không cần migration.

Không cần workaround.

Nếu một app dùng FlatList lớn không có sticky header, React Native giờ có thể tránh được việc tra cứu sticky header vốn ngay từ đầu đã không cần thiết.

Đó là kiểu cải tiến framework tôi thích nhất.

Phạm vi thay đổi nhỏ. Benchmark rõ ràng. Không đổi API.

Và một luồng phổ biến trở nên rẻ hơn cho tất cả mọi người.