Vercel React 모범 사례
React 및 Next.js 애플리케이션을 위한 포괄적인 성능 최적화 가이드, Vercel 유지 관리. 8개 카테고리, 45개 규칙으로 구성되며, 영향도에 따라 우선순위가 매겨져 자동 리팩토링 및 코드 생성을 안내합니다.
적용 시점
다음과 같은 경우 이 가이드라인을 참고하세요:
- 새 React 컴포넌트나 Next.js 페이지를 작성할 때
- 데이터 페칭(클라이언트 또는 서버 측)을 구현할 때
- 성능 이슈에 대해 코드를 검토할 때
- 기존 React/Next.js 코드를 리팩토링할 때
- 번들 크기나 로딩 시간을 최적화할 때
우선순위별 규칙 카테고리
| 우선순위 | 카테고리 | 영향도 | 접두사 |
|---|---|---|---|
| 1 | 워터폴 제거 | 중대 | async- |
| 2 | 번들 크기 최적화 | 중대 | bundle- |
| 3 | 서버 측 성능 | 높음 | server- |
| 4 | 클라이언트 측 데이터 페칭 | 중간-높음 | client- |
| 5 | 리렌더링 최적화 | 중간 | rerender- |
| 6 | 렌더링 성능 | 중간 | rendering- |
| 7 | JavaScript 성능 | 낮음-중간 | js- |
| 8 | 고급 패턴 | 낮음 | advanced- |
빠른 참조
1. 워터폴 제거 (중대)
async-defer-await- 실제로 사용되는 분기에서 await 사용async-parallel- 독립적인 작업에는 Promise.all() 사용async-dependencies- 부분 종속성에는 better-all 사용async-api-routes- API 라우트에서 Promise를 일찍 시작하고 나중에 awaitasync-suspense-boundaries- Suspense를 사용하여 콘텐츠 스트리밍
2. 번들 크기 최적화 (중대)
bundle-barrel-imports- 직접 가져오기, 배럴 파일 피하기bundle-dynamic-imports- 무거운 컴포넌트에는 next/dynamic 사용bundle-defer-third-party- 분석/로깅은 하이드레이션 후 로드bundle-conditional- 기능이 활성화된 경우에만 모듈 로드bundle-preload- 호버/포커스 시 미리 로드하여 체감 속도 향상
3. 서버 측 성능 (높음)
server-cache-react- React.cache()를 사용하여 요청별 중복 제거server-cache-lru- LRU 캐시를 사용하여 요청 간 캐싱server-serialization- 클라이언트 컴포넌트에 전달되는 데이터 최소화server-parallel-fetching- 페치를 병렬화하도록 컴포넌트 재구성server-after-nonblocking- after()를 사용하여 비차단 작업 수행
4. 클라이언트 측 데이터 페칭 (중간-높음)
client-swr-dedup- SWR을 사용하여 자동 요청 중복 제거client-event-listeners- 전역 이벤트 리스너 중복 제거
5. 리렌더링 최적화 (중간)
rerender-defer-reads- 콜백에서만 사용되는 상태를 구독하지 않기rerender-memo- 비용이 많이 드는 작업을 메모이제이션된 컴포넌트로 추출rerender-dependencies- Effect에서 원시 종속성 사용rerender-derived-state- 원시 값이 아닌 파생된 불리언 구독rerender-functional-setstate- 함수형 setState를 사용하여 안정적인 콜백 유지rerender-lazy-state-init- 비용이 큰 값에는 함수를 useState에 전달rerender-transitions- 긴급하지 않은 업데이트에는 startTransition 사용
6. 렌더링 성능 (중간)
rendering-animate-svg-wrapper- SVG 요소 대신 div 래퍼에 애니메이션 적용rendering-content-visibility- 긴 목록에는 content-visibility 사용rendering-hoist-jsx- 정적 JSX를 컴포넌트 외부로 추출rendering-svg-precision- SVG 좌표 정밀도 줄이기rendering-hydration-no-flicker- 클라이언트 전용 데이터에 인라인 스크립트 사용rendering-activity- 표시/숨김에는 Activity 컴포넌트 사용rendering-conditional-render- 조건부 렌더링에는 && 대신 삼항 연산자 사용
7. JavaScript 성능 (낮음-중간)
js-batch-dom-css- 클래스나 cssText를 통해 CSS 변경 그룹화js-index-maps- 반복 조회에는 Map 구축js-cache-property-access- 루프에서 객체 속성 캐싱js-cache-function-results- 모듈 수준 Map에 함수 결과 캐싱js-cache-storage- localStorage/sessionStorage 읽기 캐싱js-combine-iterations- 여러 filter/map을 하나의 루프로 결합js-length-check-first- 비용이 큰 비교 전에 배열 길이 확인js-early-exit- 함수에서 조기 반환js-hoist-regexp- RegExp 생성을 루프 외부로 이동js-min-max-loop- sort 대신 루프로 최소/최대값 구하기js-set-map-lookups- O(1) 조회를 위해 Set/Map 사용js-tosorted-immutable- 불변성을 위해 toSorted() 사용
8. 고급 패턴 (낮음)
advanced-event-handler-refs- 이벤트 핸들러를 ref에 저장advanced-use-latest- 안정적인 콜백 ref를 위해 useLatest 사용
사용 방법
자세한 설명과 코드 예제는 개별 규칙 파일을 참조하세요:
rules/async-parallel.md
rules/bundle-barrel-imports.md
rules/_sections.md
각 규칙 파일에는 다음이 포함됩니다:
- 규칙이 중요한 이유에 대한 간략한 설명
- 설명이 포함된 잘못된 코드 예제
- 설명이 포함된 올바른 코드 예제
- 추가 컨텍스트 및 참고 자료
전체 컴파일 문서
모든 규칙이 확장된 전체 가이드는 다음 파일을 참조하세요: AGENTS.md