Vercel React 모범 사례은(는) 무엇을 하나요?
React 및 Next.js 애플리케이션을 위한 포괄적인 성능 최적화 가이드입니다. Vercel에서 유지 관리하며, 영향도에 따라 우선순위가 매겨진 8개 카테고리, 45개의 규칙으로 구성되어 있습니다. 자동화된 리팩토링 및 코드 생성을 안내합니다.
적용 시점
다음 경우에 이 가이드라인을 참조하세요:
- 새로운 React 컴포넌트 또는 Next.js 페이지를 작성할 때
- 데이터 페칭(클라이언트 또는 서버 사이드)을 구현할 때
- 성능 이슈를 검토할 때
- 기존 React/Next.js 코드를 리팩토링할 때
- 번들 크기 또는 로드 시간을 최적화할 때
규칙 카테고리 (우선순위별)
| 우선순위 | 카테고리 | 영향 | 접두사 |
|---|---|---|---|
| 1 | 워터폴 제거 | CRITICAL | async- |
| 2 | 번들 크기 최적화 | CRITICAL | bundle- |
| 3 | 서버 사이드 성능 | HIGH | server- |
| 4 | 클라이언트 사이드 데이터 페칭 | MEDIUM-HIGH | client- |
| 5 | 리렌더링 최적화 | MEDIUM | rerender- |
| 6 | 렌더링 성능 | MEDIUM | rendering- |
| 7 | JavaScript 성능 | LOW-MEDIUM | js- |
| 8 | 고급 패턴 | LOW | advanced- |
빠른 참조
1. 워터폴 제거 (CRITICAL)
async-defer-await- 실제 사용되는 분기 내에서 await를 이동하세요.async-parallel- 독립적인 작업에는Promise.all()을 사용하세요.async-dependencies- 부분 종속성에는better-all을 사용하세요.async-api-routes- API 라우트에서는 프라미스를 일찍 시작하고 늦게 await하세요.async-suspense-boundaries- Suspense를 사용하여 콘텐츠를 스트리밍하세요.
2. 번들 크기 최적화 (CRITICAL)
bundle-barrel-imports- 배럴 파일을 피하고 직접 임포트하세요.bundle-dynamic-imports- 무거운 컴포넌트에는next/dynamic을 사용하세요.bundle-defer-third-party- 분석/로깅은 하이드레이션 후에 로드하세요.bundle-conditional- 기능이 활성화된 경우에만 모듈을 로드하세요.bundle-preload- 인지된 속도를 위해 호버/포커스 시 사전 로드하세요.
3. 서버 사이드 성능 (HIGH)
server-cache-react- 요청별 중복 제거를 위해React.cache()를 사용하세요.server-cache-lru- 요청 간 캐싱을 위해 LRU 캐시를 사용하세요.server-serialization- 클라이언트 컴포넌트로 전달되는 데이터를 최소화하세요.server-parallel-fetching- 페치를 병렬화하도록 컴포넌트를 재구성하세요.server-after-nonblocking- 비차단 작업에는after()를 사용하세요.
4. 클라이언트 사이드 데이터 페칭 (MEDIUM-HIGH)
client-swr-dedup- 자동 요청 중복 제거를 위해 SWR을 사용하세요.client-event-listeners- 전역 이벤트 리스너를 중복 제거하세요.
5. 리렌더링 최적화 (MEDIUM)
rerender-defer-reads- 콜백에서만 사용되는 상태를 구독하지 마세요.rerender-memo- 비용이 많이 드는 작업을 메모이제이션된 컴포넌트로 추출하세요.rerender-dependencies- Effect에서 기본형 의존성을 사용하세요.rerender-derived-state- 원시값이 아닌 파생된 불리언 값을 구독하세요.rerender-functional-setstate- 안정적인 콜백을 위해 함수형setState를 사용하세요.rerender-lazy-state-init- 비용이 많이 드는 값에는useState에 함수를 전달하세요.rerender-transitions- 긴급하지 않은 업데이트에는startTransition을 사용하세요.
6. 렌더링 성능 (MEDIUM)
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 성능 (LOW-MEDIUM)
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. 고급 패턴 (LOW)
advanced-event-handler-refs- 이벤트 핸들러를 ref에 저장하세요.advanced-use-latest- 안정적인 콜백 ref를 위해useLatest를 사용하세요.
사용 방법
자세한 설명과 코드 예제는 개별 규칙 파일을 읽으세요:
rules/async-parallel.md
rules/bundle-barrel-imports.md
rules/_sections.md
각 규칙 파일에는 다음이 포함되어 있습니다:
- 왜 중요한지에 대한 간략한 설명
- 설명이 포함된 잘못된 코드 예제
- 설명이 포함된 올바른 코드 예제
- 추가 컨텍스트 및 참고 자료
전체 문서
모든 규칙이 확장된 전체 가이드는 AGENTS.md를 참조하세요.