네, 제대로 읽으셨습니다. 8000배 빨라졌습니다.
"이제 앱 전체가 8000배 빨라졌으니 요트를 사러 가세요" 수준은 아닙니다. 아쉽게도요.
그리고 네, 타이밍이 좀 웃기다는 것도 압니다.
우리는 AI 뉴스가 너무 빨리 바뀌어서 Claude Fable 5가 출시되고 며칠 뒤에 중단될 수 있는 시대에 살고 있습니다. 사람들은 AGI에 가까운 모델, 수출 통제, 프로젝트 전체를 해내는 에이전트 같은 것들을 두고 논쟁하고 있습니다.
그런데 저는 여기서 React Native 리스트를 빠르게 만드는 이야기를 하고 있습니다.
두 가지를 나란히 놓으면 좀 이상하게 들리죠. 이해합니다.
그래도 저는 이런 작업이 여전히 흥미롭습니다. "발명"이라는 말은 너무 거창할지 모르지만, 수천 개의 앱이 쓰는 프레임워크를 개선하는 일은 제게 여전히 의미 있게 느껴집니다. 쓸모 있는 모든 것이 SF처럼 보일 필요는 없습니다. 때로는 거의 모든 모바일 앱이 거치는 경로에서 낭비되는 일을 덜어 내는 것일 뿐입니다.
이번 성과는 React Native 리스트의 특정 경로 하나에 있습니다. 바로 지금 어떤 셀이 존재해야 하는지 정하는 렌더 윈도우 작업입니다. 벤치마크에서 기존 경로는 거대한 리스트에서 몇 초를 낭비할 수 있었는데, 새 경로는 이를 몇 밀리초로 줄입니다.
우리는 대부분의 시간을 앱 쪽에서 보냅니다. FlatList, SectionList, 내비게이션, 애니메이션, 상태 관리 라이브러리 같은 익숙한 것들을 씁니다. 성능에 대해 불평하고, prop을 몇 개 바꿔 보고, memo를 붙이고, 어쩌면 getItemLayout도 추가한 다음 그냥 넘어갑니다.
하지만 때로는 진짜 문제가 앱 코드보다 한 층 아래에 있습니다.
이번이 그런 경우였습니다.
저는 react/react-native에 성능 개선을 기여했고, PR #57210으로 머지되었습니다. 이 변경은 VirtualizedList가 사용하는 렌더 마스크 생성 경로에서 불필요한 sticky header 탐색 작업을 없앱니다.
쉽게 말하면, React Native는 리스트에 sticky header가 하나도 없을 때도 가끔 sticky header를 찾고 있었습니다.
전형적인 컴퓨터다운 순간입니다.
리스트: "나는 sticky header가 없어."
React Native: "좋아, 그럼 하나 찾으러 거꾸로 훑어볼게."
좋은 점은 이 경로가 공용이라는 것입니다. 그래서 이 개선은 다음에 영향을 줍니다.
VirtualizedListFlatListVirtualizedSectionListSectionList
그리고 네, sticky header를 전혀 쓰지 않더라도 일반적인 FlatList 사용에서 혜택을 볼 수 있습니다.
실제로 무엇이 개선되는가
코드로 들어가기 전에, 이것이 어떤 종류의 성능인지 짚고 넘어갈 필요가 있습니다.
개선된 부분은 React Native가 어떤 행을 렌더링할지 결정하기 전에 하는 JavaScript 작업입니다.
FlatList는 렌더 윈도우를 유지합니다. 스크롤하거나, 점프하거나, 초기 인덱스 근처에서 마운트하거나, 큰 리스트 안을 이동할 때 React Native는 어떤 셀을 렌더링하고 어떤 부분을 빈 공간(spacer)으로 둘지 정해야 합니다.
그 결정은 VirtualizedList._createRenderMask를 거칩니다.
그러니 얻는 것은 이렇습니다.
- 리스트 윈도우를 업데이트할 때 JS 작업 감소
- 거대한 리스트의 끝부분 근처로 점프할 때 작업 감소
- sticky header가 없는 리스트에서 불필요한 sticky header 로직 감소
- 리스트가 화면에 무엇을 둘지 업데이트하기 전의 결정이 더 빨라짐
일반적인 앱 관점에서 보면, 이 개선은 FlatList에서 "지금 어떤 행이 존재해야 하지?"를 결정하는 부분을 돕습니다.
아주 큰 리스트, 특히 리스트 끝부분 근처에서는 이 작은 내부 결정이 실제 비용이 될 수 있습니다.
그 비용을 없애면 렌더 윈도우 업데이트 경로가 훨씬 가벼워집니다.
제가 발견한 것
FlatList는 거의 모든 React Native 앱이 언젠가는 쓰는 컴포넌트입니다.
밖에서 보면 단순해 보입니다.
<FlatList data={items} renderItem={renderItem} />
하지만 내부적으로는 VirtualizedList를 거칩니다.
VirtualizedList는 데이터 소스 전체를 렌더링하지 않습니다. 행이 10만 개 있어도, 용감하지만 가망 없는 병사처럼 10만 개를 전부 화면에 올리지 않습니다. 렌더 윈도우를 유지하고, 렌더 마스크로 지금 어떤 셀이 존재해야 하는지 정합니다.
좋은 방식입니다.
문제는 렌더 마스크를 만드는 단계 안에 있었습니다.
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,
);
그러면 헬퍼는 첫 번째로 보이는 셀부터 거꾸로 훑어 나갔습니다.
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 header가 없는 일반적인 FlatList 사용에 중요한 부분입니다.
const stickyHeaderIndices = props.stickyHeaderIndices;
if (stickyHeaderIndices != null && stickyHeaderIndices.length > 0) {
VirtualizedList._ensureClosestStickyHeader(
props,
stickyHeaderIndices,
renderMask,
cellsAroundViewport.first,
);
}
sticky header가 없으면 헬퍼를 건너뜁니다.
두 번째 부분은 sticky header가 있는 경우도 개선합니다.
항목 인덱스를 거꾸로 훑는 대신, 헬퍼는 설정된 sticky header 인덱스들을 훑어서 뷰포트 앞에 있는 가장 가까운 유효한 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가 있으면 인덱스가 하나씩 밀립니다.
이 모든 것이 여전히 동작해야 합니다.
테스트는 이런 경우들을 다룹니다.
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에도 있습니다.
시뮬레이터 데모에서 기존 경로는 리스트 크기에 따라 늘어납니다. 렌더 윈도우 업데이트 1천 번 기준으로 이렇습니다.
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번 기준으로는 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가 어떤 셀을 렌더링할지 정하기 전, 공용 리스트 경로에서 그만큼의 시간이 사라진 것입니다.
테스트 계획
저는 이 변경이 가장 좋은 의미에서 지루하길 바랐습니다. 동작은 같고, 일은 줄어드는 것.
그래서 기여에는 동작 테스트와 벤치마크가 포함되었습니다.
주요 명령어는 이것들이었습니다.
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 렌더 마스크 경로를 위한 Fantom 벤치마크
Meta의 절차를 통해 내부로 임포트된 뒤 react/react-native에 머지되었습니다.
마무리
이 기여에서 제가 좋아하는 점은 앱 개발자가 아무것도 할 필요가 없다는 것입니다.
새 prop 없음.
마이그레이션 없음.
우회책 없음.
앱이 sticky header 없이 큰 FlatList를 쓴다면, React Native는 이제 애초에 불필요했던 sticky header 탐색 작업을 건너뛸 수 있습니다.
제가 가장 좋아하는 종류의 프레임워크 개선입니다.
작은 변경 범위. 명확한 벤치마크. API 변경 없음.
그리고 흔히 쓰이는 경로가 모두에게 더 가벼워집니다.