useMemo를 지워도 될까요, 이 블로그에 React Compiler를 켜고 빌드해 봤습니다
Next.js 16에서 React Compiler 설정이 정식 옵션이 됐습니다. 이 블로그에 실제로 켜고 빌드해 보면서 어떤 컴포넌트가 컴파일되고 어떤 컴포넌트가 조용히 건너뛰어지는지, 번들에는 무엇이 남는지 확인했습니다.
React 19 다시 배우기· 4 / 4펼치기접기
- 1. pending과 error를 useState로 들고 있던 로그인 폼, React 19 Actions로 다시 써 보기
- 2. 댓글을 달면 바로 보이게, TanStack Query로 해 둔 낙관적 업데이트를 useOptimistic과 비교해 봤습니다
- 3. getState()로 최신 값을 꺼내던 useEffect, use와 useEffectEvent로 덜어내기
- 4. useMemo를 지워도 될까요, 이 블로그에 React Compiler를 켜고 빌드해 봤습니다
이 블로그 코드에서 useMemo와 useCallback을 찾아보면 lab의 지도 예제 두 개에서만 나옵니다. 나머지 컴포넌트에는 하나도 없습니다. 성능 문제가 없었으니 굳이 넣지 않았던 건데, React Compiler를 켜면 이 "굳이"를 컴파일러가 대신해 준다고 합니다.
시리즈 마지막 글에서는 React Compiler를 이 블로그에 실제로 켜고 빌드해 봤습니다. 앞의 세 편은 다시 쓴 예시 코드였지만, 이번에는 직접 돌려 본 결과입니다. 다만 별도의 작업 공간에서 켜 본 것이고, 블로그 설정에는 아직 반영하지 않았습니다.
1. 컴파일러는 빌드할 때 메모이제이션을 넣어 줍니다
React Compiler는 빌드 단계에서 컴포넌트와 훅을 분석해, 다시 계산하지 않아도 되는 값과 JSX를 알아서 기억해 두는 코드로 바꿔 줍니다. 사람이 useMemo, useCallback, memo로 하던 메모이제이션(memoization)을 컴파일러가 하는 셈입니다.
전제는 컴포넌트가 React의 규칙을 지킨다는 것입니다. 렌더링 중에 바깥 값을 바꾸지 않고, 같은 입력이면 같은 결과를 내야 합니다. 컴파일러는 규칙을 지키는지 확신할 수 없는 컴포넌트는 손대지 않고 원래대로 둡니다. 이 "손대지 않는다"가 나중에 중요해집니다.
2. Next.js 16에서는 설정 한 줄입니다
Next.js 16 업그레이드 문서에 따르면, React Compiler 1.0이 나오면서 reactCompiler 옵션이 실험 기능에서 정식 옵션으로 올라왔습니다. 기본값은 꺼져 있습니다. 보통은 babel-plugin-react-compiler를 개발 의존성으로 설치하고 설정을 켭니다.
이 블로그가 쓰는 Next.js 16.3에는 컴파일러를 Rust로 옮긴 버전을 Turbopack 안에서 바로 돌리는 실험 옵션도 있습니다. 이 옵션을 쓰면 Babel 플러그인을 따로 설치하지 않아도 됩니다. 의존성을 늘리지 않고 시험해 보고 싶어서 이쪽을 택했습니다.
// next.config.ts
const nextConfig: NextConfig = {
allowedDevOrigins: ["127.0.0.1"],
reactCompiler: true,
experimental: { turbopackRustReactCompiler: true },
};컴파일러를 처음 들일 때 전체가 아니라 일부 컴포넌트에만 켜는 방법도 있습니다. compilationMode: "annotation"으로 두면 함수 맨 위에 "use memo"를 적은 컴포넌트만 컴파일합니다. 반대로 특정 컴포넌트만 빼고 싶으면 "use no memo"를 적습니다.
3. 빌드는 그대로 통과했습니다
설정을 켜기 전과 후로 next build를 한 번씩 돌렸습니다. 둘 다 에러 없이 끝났고, 정적으로 만들어진 페이지도 51개로 같았습니다. 경고 메시지도 컴파일러를 켜기 전과 같았습니다.
컴파일러가 정말 일을 했는지는 결과물에서 확인했습니다. 컴파일된 컴포넌트는 기억해 둔 값을 담는 캐시를 쓰는데, 이때 react.memo_cache_sentinel이라는 표식이 코드에 들어갑니다. 브라우저로 내려가는 JavaScript에서 이 표식을 세어 봤습니다.
| 항목 | 끄고 빌드 | 켜고 빌드 |
|---|---|---|
| 캐시 표식이 나온 횟수 | 1 | 71 |
| 클라이언트 JavaScript 크기 | 3,724KB | 3,748KB |
꺼져 있을 때 나온 1번은 React 런타임 자체에 들어 있는 정의입니다. 켜고 나니 검색 팔레트, 댓글, 글 에디터, 로그인 폼이 들어 있는 파일에서 표식이 나왔습니다. 그만큼 캐시 코드가 붙어서 클라이언트 JavaScript가 24KB쯤 늘었습니다.
빌드 시간도 재긴 했지만 한 번씩만 돌린 거라 비교라고 하기는 어렵습니다. 체감할 만한 차이는 없었다는 정도만 적어 둡니다.
4. 지도 예제 두 개는 조용히 건너뛰어졌습니다
표식을 세다가 이상한 점을 발견했습니다. useMemo와 useCallback을 쓰고 있던 바로 그 지도 예제 두 개에서는 표식이 하나도 나오지 않았습니다. 빌드 로그에는 아무 말도 없었습니다.
이유를 알고 싶어서, 작업 공간에 babel-plugin-react-compiler 1.0.0을 설치하고 로그를 남기게 해서 클라이언트 컴포넌트를 전부 돌려 봤습니다. 컴포넌트와 훅 20개는 컴파일됐고, 지도 예제 두 개는 이런 이유로 건너뛰었습니다.
NeighborhoodMap.tsx (BuildHIR::lowerExpression) Handle ImportExpression expressions
MapboxDemo.tsx (BuildHIR::lowerExpression) Handle ImportExpression expressions
MapboxDemo.tsx (BuildHIR::lowerExpression) Handle UpdateExpression to variables captured within lambdas.두 컴포넌트 모두 지도 라이브러리를 effect 안에서 import()로 늦게 불러옵니다. 무거운 지도 엔진을 처음 화면에 같이 내려보내지 않으려고 그렇게 짰는데, 컴파일러는 아직 이 문법을 다루지 못합니다. MapboxDemo에는 콜백 안에서 바깥 변수를 ++loaded처럼 바꾸는 코드도 있었습니다.
로그의 분류를 보면 규칙 위반이 아니라 컴파일러가 아직 지원하지 않는 문법(Todo)입니다. 코드가 틀렸다는 뜻은 아니지만, 결과는 같습니다. 컴파일러를 켰다고 해서 모든 컴포넌트가 메모이제이션되는 건 아니었습니다.
5. 그래서 useMemo는 아직 지우지 않기로 했습니다
이 글 제목의 질문으로 돌아가 보면, 지울 수 있는 useMemo가 이 블로그에는 없었습니다. 남아 있던 useMemo와 useCallback은 모두 컴파일러가 건너뛴 컴포넌트 안에 있었기 때문입니다. 컴파일러를 믿고 지웠다면 메모이제이션이 그냥 사라졌을 겁니다.
게다가 3편에서 봤듯이 지도 예제의 useCallback은 성능이 아니라 effect를 다시 실행하지 않으려고 쓴 것이었습니다. 이런 경우는 컴파일러가 처리하든 안 하든 useEffectEvent로 의도를 드러내는 편이 맞다고 생각합니다.
컴파일러가 건너뛰는 컴포넌트를 미리 알 방법도 필요해 보였습니다. React 팀은 컴파일러의 판단을 ESLint 규칙으로도 제공하는데, 이 블로그에는 아직 ESLint 설정이 없습니다. 오늘처럼 로그를 직접 남겨 보는 것도 방법이지만, 매번 하기는 어렵습니다.
마치며
설정 한 줄로 컴포넌트 20개에 메모이제이션이 붙는 건 분명 편했습니다. 하지만 건너뛴 컴포넌트에 대해서는 아무 말도 해 주지 않았고, 하필 메모이제이션이 필요했던 곳이 거기였습니다. 켜는 것보다 무엇이 빠졌는지 확인하는 데 시간이 더 걸렸습니다.
블로그에 반영하는 일은 앞으로 해 볼 일로 남겨 두었습니다. 빌드가 통과한 것과 화면이 똑같이 동작하는 것은 다른 문제라서, 댓글과 에디터를 직접 눌러 보며 확인한 뒤에 켤 생각입니다. 이번 시리즈를 쓰면서 React 19의 새 API를 하나씩 대입해 보니, 바꿀 수 있는 코드보다 지금 코드가 왜 그렇게 짜였는지를 더 많이 알게 됐습니다.
Comments (0)