React Academy · 강의

묶음 분석과 코드 분할 전략

rollup-plugin-visualizer로 묶음 크기를 분석하고 경로별 코드 분할 전략을 세웁니다.

레슨 2/412개 단계

묶음 분석과 코드 분할 전략은(는) CoddyKit의 무료 React Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 React Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

번들 크기가 중요한 이유

큰 JavaScript 번들은 상호작용 가능 시간(Time To Interactive)을 지연시킵니다. 특히 느린 모바일 네트워크에서는 페이지가 상호작용 가능해지기 전에 모든 JS를 다운로드하고 파싱한 뒤 실행해야 합니다.

rollup-plugin-visualizer로 분석하기

Vite 프로젝트에서는 시각화 플러그인을 사용해 번들에서 어떤 모듈이 가장 많은 공간을 차지하는지 보여 주는 트리맵을 생성합니다.

// vite.config.ts
import { visualizer } from 'rollup-plugin-visualizer';

export default defineConfig({
  plugins: [
    visualizer({ open: true, gzipSize: true, brotliSize: true })
  ],
});

// After build, open the generated HTML file to explore the treemap

Next.js 번들 분석기

@next/bundle-analyzer를 사용해 Next.js의 서버 및 클라이언트 번들을 분석합니다.

npm install @next/bundle-analyzer

// next.config.js
const withBundleAnalyzer = require('@next/bundle-analyzer')({
  enabled: process.env.ANALYZE === 'true',
});

module.exports = withBundleAnalyzer({});

// Run:
// ANALYZE=true npm run build

경로 기반 코드 분할

가장 효과적인 분할 방법은 사용자가 해당 경로로 이동할 때만 각 경로의 코드를 로드하는 것입니다. React Router의 lazy()와 Next.js App Router는 이를 자동으로 처리합니다.

// React Router v6 with lazy loading
import { lazy, Suspense } from 'react';

const Dashboard = lazy(() => import('./pages/Dashboard'));
const Settings = lazy(() => import('./pages/Settings'));

<Routes>
  <Route path="/dashboard" element={<Suspense fallback={<Loading />}><Dashboard /></Suspense>} />
  <Route path="/settings" element={<Suspense fallback={<Loading />}><Settings /></Suspense>} />
</Routes>

컴포넌트 수준 코드 분할

lazy()를 사용해 지도, 차트, 편집기 같은 무거운 컴포넌트가 필요할 때까지 로드를 지연합니다.

const MonacoEditor = lazy(() => import('@monaco-editor/react'));
const MapView = lazy(() => import('./MapView'));

function ProductEditor({ showMap }) {
  return (
    <>
      <Suspense fallback={<EditorSkeleton />}><MonacoEditor /></Suspense>
      {showMap && <Suspense fallback={<MapSkeleton />}><MapView /></Suspense>}
    </>
  );
}

조건부 기능을 위한 동적 가져오기

모든 사용자가 로드하지 않도록 기능이 활성화될 때만 큰 라이브러리를 가져옵니다.

async function exportToPDF() {
  const { default: jsPDF } = await import('jspdf'); // ~300KB — loaded on demand
  const doc = new jsPDF();
  doc.text('Hello', 10, 10);
  doc.save('export.pdf');
}

트리 셰이킹

최신 번들러는 사용하지 않는 내보내기, 즉 데드 코드를 제거합니다. 트리 셰이킹이 작동하도록 종속성이 ESM(CJS가 아님)을 지원하는지 확인하고, 함수 하나만 사용할 때는 라이브러리 전체를 가져오지 않습니다.

// Bad — imports entire lodash (~70KB):
import _ from 'lodash';
const result = _.debounce(fn, 300);

// Good — imports only debounce (<2KB):
import debounce from 'lodash/debounce';
// or with tree-shaking-friendly lodash-es:
import { debounce } from 'lodash-es';

중요한 청크 미리 로드

<link rel='modulepreload'> 또는 Webpack 매직 주석을 사용해 사용자가 현재 페이지에 있는 동안 다음 페이지의 chunk를 미리 로드합니다.

// Webpack magic comment — preload on hover:
const Dashboard = lazy(() => import(/* webpackPrefetch: true */ './Dashboard'));
// or preload (higher priority):
const Dashboard = lazy(() => import(/* webpackPreload: true */ './Dashboard'));

서드 파티 영향 분석

설치하기 전에 bundlephobia.com 또는 Import Cost VS Code 확장 프로그램을 사용해 npm 패키지의 gzip 압축 크기를 확인합니다.

번들 예산 설정

Webpack 또는 Vite 설정에서 경로별 크기 제한을 설정합니다. 청크가 예산을 초과하면 빌드가 실패하므로 CI에서 실수로 발생한 크기 증가를 발견할 수 있습니다.

// vite.config.ts
build: {
  rollupOptions: {
    output: {
      manualChunks: {
        'vendor-react': ['react', 'react-dom'],
        'vendor-router': ['react-router-dom'],
      },
    },
  },
  chunkSizeWarningLimit: 200, // warn at 200KB
},

빠른 확인

페이지가 많은 React SPA에서 가장 효과적인 코드 분할 전략은 무엇입니까?

인터랙티브 레슨에서 답해보세요

요약

rollup-plugin-visualizer 또는 @next/bundle-analyzer로 번들을 분석합니다. 경로 수준과 컴포넌트 수준에서 lazy()를 사용해 분할합니다. 사용하는 항목만 가져와 트리 셰이킹을 적용합니다. CI에서 크기 예산을 설정하고, 다음에 방문할 가능성이 높은 경로에 프리페치 및 미리 로드 힌트를 사용합니다.

무료로 시작

AI 튜터와 함께 React을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스: 88
레슨: 324

무료로 학습 시작 전체 코스 보기

자주 묻는 질문

“묶음 분석과 코드 분할 전략” 강의는 무료인가요?

네 — “묶음 분석과 코드 분할 전략” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 React Academy 강의 전체를 잠금 해제할 수 있습니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“묶음 분석과 코드 분할 전략”에서 뭘 배우나요?

rollup-plugin-visualizer로 묶음 크기를 분석하고 경로별 코드 분할 전략을 세웁니다. 브라우저에서 직접 실행하는 실습 코드로 React Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

React Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 React Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“묶음 분석과 코드 분할 전략” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 React Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 React Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← React Academy(으)로 돌아가기