Vite Build Tool: Modern Frontend Development 완벽 가이드

최근 몇 년간 프론트엔드 개발 생태계는 눈부신 발전을 거듭하며, 더욱 복잡하고 거대한 애플리케이션을 구축할 수 있게 되었습니다. 하지만 이러한 발전과 함께 개발 환경 설정 및 빌드 프로세스의 복잡성과 시간이 증가하는 문제에 직면하게 되었습니다. 이러한 배경 속에서 등장한 Vite는 개발 생산성과 경험을 혁신적으로 개선하는 차세대 빌드 도구로 빠르게 자리매김하고 있습니다.

이 글에서는 Vite가 왜 필요한지, 기존 빌드 도구와 어떤 차이점이 있는지부터 시작하여, Vite 프로젝트를 시작하고 React, TypeScript, CSS, JavaScript와 같은 현대적인 프론트엔드 기술 스택과 함께 활용하는 방법에 대해 심층적으로 다룹니다. 또한, 고급 설정과 플러그인 활용, 그리고 배포를 위한 최적화 전략까지 Vite의 모든 것을 완벽하게 가이드해 드리겠습니다.

Vite는 왜 필요한가? 기존 빌드 도구와의 차이점

과거의 프론트엔드 개발은 Gulp, Grunt와 같은 태스크 러너를 거쳐 Webpack, Rollup과 같은 모듈 번들러 시대로 발전했습니다. 이들은 복잡한 모듈 의존성을 관리하고, 다양한 리소스를 번들링하여 브라우저가 이해할 수 있는 형태로 변환하는 데 필수적인 역할을 수행했습니다. 특히 Webpack은 사실상의 표준으로 자리 잡으며 수많은 프로젝트에서 활용되었습니다.

하지만 Webpack과 같은 번들러는 프로젝트 규모가 커질수록 몇 가지 한계를 드러냈습니다.

1. 느린 콜드 스타트 (Cold Start): 개발 서버를 시작할 때 모든 애플리케이션 코드를 미리 번들링해야 하므로, 프로젝트가 커질수록 서버 시작 시간이 길어졌습니다.
2. 느린 HMR (Hot Module Replacement): 코드 변경 시 변경된 모듈뿐만 아니라 관련 모듈까지 재빌딩해야 하는 경우가 많아, HMR 속도가 기대만큼 빠르지 않은 경우가 있었습니다.

Vite는 이러한 문제점들을 해결하기 위해 다음과 같은 혁신적인 접근 방식을 채택했습니다.

• ES Modules 기반 개발 서버: Vite는 개발 시 ES Modules(ESM)를 네이티브로 지원하는 브라우저의 특성을 활용합니다. 즉, 개발 서버에서 코드를 번들링하지 않고, 브라우저가 필요한 모듈을 요청하면 그때그때 제공합니다. 이는 개발 서버의 콜드 스타트 시간을 획기적으로 단축시킵니다.
• esbuild를 이용한 사전 번들링: node_modules에 있는 의존성들은 CommonJS 형태로 되어 있거나 수많은 모듈로 쪼개져 있는 경우가 많습니다. Vite는 이러한 의존성들을 Go 언어로 작성된 초고속 번들러인 esbuild를 사용하여 ESM 형태로 사전 번들링합니다. 이 과정은 JavaScript 기반 번들러보다 10~100배 빠르게 처리됩니다.
• 초고속 HMR: ESM 기반의 개발 서버 덕분에, 코드 변경 시 변경된 모듈만 브라우저에 전달되어 교체됩니다. 이는 HMR 속도를 압도적으로 빠르게 만들어 개발 경험을 크게 향상시킵니다.

다음 표는 Webpack과 Vite의 주요 특징을 비교하여 보여줍니다.

특징	Webpack	Vite
개발 서버	모든 모듈 번들링 후 제공	ES Modules 기반, 필요한 모듈만 브라우저가 요청
콜드 스타트	프로젝트 규모에 따라 느려질 수 있음	매우 빠름 (ES Modules, esbuild 사전 번들링)
HMR	번들러에 의존, 전체 재빌딩 필요 시 느림	브라우저의 ESM 캐싱 활용, 변경된 모듈만 교체 (매우 빠름)
빌드 도구	자체 번들러 (JavaScript)	Rollup (JavaScript) + esbuild (Go)
설정 복잡성	상대적으로 복잡 (로더, 플러그인 등)	비교적 간결, sensible defaults

Vite 프로젝트 시작하기

Vite 프로젝트를 시작하는 것은 매우 간단합니다. npm create vite@latest 명령어를 통해 다양한 프레임워크(React, Vue, Preact, Svelte, Lit 등)와 TypeScript를 포함한 템플릿을 선택하여 프로젝트를 생성할 수 있습니다.

1. 프로젝트 생성 명령어 실행:

터미널에서 다음 명령어를 실행합니다.

npm create vite@latest

명령어를 실행하면 프로젝트 이름, 사용할 프레임워크, 그리고 TypeScript 사용 여부를 선택하는 프롬프트가 나타납니다.

✔ Project name: › my-vite-app
✔ Select a framework: › React
✔ Select a variant: › TypeScript

위와 같이 my-vite-app이라는 이름으로 React와 TypeScript 템플릿을 선택하여 프로젝트를 생성할 수 있습니다.

2. 프로젝트 디렉토리로 이동 및 의존성 설치:

프로젝트 생성이 완료되면 해당 디렉토리로 이동하여 필요한 의존성들을 설치합니다.

cd my-vite-app
npm install

3. 개발 서버 실행:

의존성 설치가 완료되면 다음 명령어로 개발 서버를 실행할 수 있습니다.

npm run dev

서버가 성공적으로 실행되면 터미널에 로컬 개발 서버 URL이 표시되며, 해당 URL로 접속하면 Vite + React + TypeScript로 구성된 기본 애플리케이션을 확인할 수 있습니다.

  VITE v5.x.x  ready in X ms

  ➜  Local:   http://localhost:5173/
  ➜  Network: use --host to expose
  ➜  press h + enter to show help

4. 프로덕션 빌드:

애플리케이션을 배포하기 위한 프로덕션 빌드는 다음 명령어로 수행합니다.

npm run build

이 명령어는 dist 디렉토리에 최적화된 빌드 결과물을 생성합니다.

핵심 기능 분석: 개발 서버와 빌드 시스템

Vite의 핵심은 개발 환경과 프로덕션 빌드 환경에서 각각 최적화된 전략을 사용하는 것입니다.

개발 서버 (Development Server)

Vite 개발 서버는 ESM 기반으로 작동하며, node_modules에 있는 의존성 사전 번들링을 위해 esbuild를 사용합니다.

• ESM 기반 네이티브 모듈: 브라우저는 <script type="module"> 태그를 통해 ES Modules를 직접 로드할 수 있습니다. Vite는 이 기능을 활용하여 개발 시에는 코드를 번들링하지 않고, 브라우저가 필요로 하는 모듈을 개별적으로 HTTP 요청하여 가져오도록 합니다. 이는 개발 서버의 콜드 스타트 시간을 극단적으로 줄여줍니다.
• 초고속 HMR (Hot Module Replacement): 코드를 수정하면 Vite는 변경된 모듈만 감지하여 브라우저에 푸시합니다. 브라우저는 해당 모듈만 교체하여 애플리케이션 상태를 유지한 채 UI를 업데이트합니다. 이 과정은 매우 빠르며, 복잡한 Webpack 설정 없이도 즉각적인 피드백을 제공합니다.
• 의존성 사전 번들링: node_modules에 있는 의존성들은 대부분 CommonJS(CJS) 형식이며, 수많은 파일로 쪼개져 있습니다. Vite는 개발 서버 시작 시 esbuild를 사용하여 이러한 의존성들을 ESM 형식으로 사전 번들링합니다. 이로 인해 브라우저가 수백, 수천 개의 HTTP 요청을 보내는 대신, 몇 개의 큰 번들 파일만 요청하게 되어 성능이 향상됩니다.

빌드 시스템 (Build System)

프로덕션 빌드 시에는 Rollup을 기반으로 최적화된 번들링을 수행합니다.

• Rollup 기반의 최적화: Vite는 프로덕션 빌드를 위해 강력하고 유연한 Rollup.js를 내부적으로 사용합니다. Rollup은 JavaScript 라이브러리 번들링에 최적화되어 있으며, Tree-shaking, Code Splitting과 같은 고급 최적화 기능을 제공합니다.
• Tree-shaking: 사용되지 않는 코드를 최종 번들에서 제거하여 파일 크기를 줄입니다.
• Code Splitting: 애플리케이션 코드를 여러 개의 작은 청크(chunk)로 분할하여, 필요한 시점에만 로드되도록 하여 초기 로딩 성능을 향상시킵니다.
• 정적 자산 처리: 이미지, 폰트, CSS 파일 등 다양한 정적 자산들을 효율적으로 처리하며, 파일 이름에 해시를 추가하여 캐싱 문제를 해결합니다.

vite.config.ts 파일은 Vite의 동작을 설정하는 핵심 파일입니다. 기본 설정은 다음과 같습니다.

// vite.config.ts
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react'; // React 플러그인 임포트

// https://vitejs.dev/config/
export default defineConfig({
  plugins: [react()], // React 플러그인 사용
  server: {
    port: 3000, // 개발 서버 포트 설정
    open: true, // 개발 서버 시작 시 자동으로 브라우저 열기
  },
  build: {
    outDir: 'dist', // 빌드 결과물이 저장될 디렉토리
    sourcemap: true, // 소스맵 생성 여부
  },
});

defineConfig 헬퍼 함수는 Vite 설정 객체를 정의하며, 자동완성 기능을 제공하여 설정 오류를 줄이는 데 도움을 줍니다.

Vite와 함께하는 React, TypeScript 개발

Vite는 React 및 TypeScript 프로젝트를 위한 훌륭한 개발 환경을 제공합니다. npm create vite@latest --template react-ts 명령어를 통해 이미 기본적인 React + TypeScript 프로젝트 구조가 설정됩니다.

TypeScript 설정

Vite는 tsconfig.json 파일을 자동으로 감지하고, esbuild를 통해 TypeScript를 JavaScript로 빠르게 트랜스파일링합니다. 타입 검사는 개발 서버와 별도로 실행되므로, 개발 속도에 영향을 주지 않습니다.

CSS Preprocessors 및 CSS Modules

Vite는 Sass, Less, Stylus와 같은 CSS 전처리기들을 별도의 설정 없이 바로 사용할 수 있도록 지원합니다.

1. Sass 설치:

npm install -D sass

2. vite.config.ts 설정 (선택 사항):

additionalData 옵션을 통해 전역 Sass 변수나 믹스인을 모든 Sass 파일에 자동으로 주입할 수 있습니다.

// vite.config.ts
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';

export default defineConfig({
  plugins: [react()],
  css: {
    preprocessorOptions: {
      scss: {
        // 모든 scss 파일에 자동으로 포함될 전역 변수/믹스인 파일 지정
        additionalData: `@import "./src/styles/variables.scss";`,
      },
    },
    // CSS Modules 활성화 예시
    modules: {
      localsConvention: 'camelCaseOnly', // 클래스 이름을 camelCase로 변환
      generateScopedName: '[name]_[local]_[hash:base64:5]', // 스코프된 클래스 이름 생성 규칙
    },
  },
});

3. CSS Modules 사용:

Vite는 .module.css (또는 .module.scss)와 같은 파일 확장자를 통해 CSS Modules를 자동으로 지원합니다.

// src/App.tsx
import React, { useState } from 'react';
import styles from './App.module.css'; // CSS Modules 임포트

function App() {
  const [count, setCount] = useState(0);

  return (
    <div className={styles.appContainer}> {/* CSS Module 클래스 사용 */}
      <h1>Vite + React + TypeScript</h1>
      <button onClick={() => setCount((prev) => prev + 1)}>
        Count is: {count}
      </button>
      <p>API URL: {import.meta.env.VITE_API_URL}</p>
    </div>
  );
}

export default App;

/* src/App.module.css */
.appContainer {
  font-family: Arial, sans-serif;
  text-align: center;
  margin-top: 50px;
  background-color: #f0f0f0;
  padding: 20px;
  border-radius: 8px;
}
button {
  padding: 10px 20px;
  font-size: 16px;
  cursor: pointer;
  background-color: #007bff;
  color: white;
  border: none;
  border-radius: 5px;
  margin-top: 10px;
}

환경 변수 (Environment Variables)

Vite는 import.meta.env 객체를 통해 환경 변수에 접근할 수 있도록 합니다. VITE_ 접두사로 시작하는 환경 변수만 클라이언트 측 코드에 노출됩니다.

.env 파일에 환경 변수를 정의할 수 있습니다.

# .env 파일
VITE_API_URL=http://localhost:8080/api
VITE_SOME_KEY=mysecretkey

클라이언트 코드에서 사용:

// src/main.tsx 또는 다른 컴포넌트 파일
console.log(import.meta.env.VITE_API_URL); // "http://localhost:8080/api"
console.log(import.meta.env.VITE_SOME_KEY); // "mysecretkey"
console.log(import.meta.env.MODE); // 개발 모드: "development", 프로덕션 모드: "production"

고급 설정 및 플러그인 활용

Vite의 강력함은 유연한 설정과 풍부한 플러그인 생태계에서도 드러납니다.

플러그인 (Plugins)

Vite 플러그인은 Rollup 플러그인 인터페이스를 확장하여 개발 서버와 빌드 프로세스 모두를 사용자 정의할 수 있도록 합니다. Awesome Vite 리포지토리에서 다양한 공식 및 커뮤니티 플러그인을 찾아볼 수 있습니다.

예를 들어, SVG 파일을 React 컴포넌트로 사용할 수 있게 해주는 vite-plugin-svgr 플러그인을 사용해 보겠습니다.

1. 플러그인 설치:

npm install -D vite-plugin-svgr

2. vite.config.ts 설정:

// vite.config.ts
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
import svgr from 'vite-plugin-svgr'; // svgr 플러그인 임포트

export default defineConfig({
  plugins: [
    react(),
    svgr({
      svgrOptions: {
        icon: true, // SVG를 React 컴포넌트로 변환 시 아이콘 속성 추가
      },
    }),
  ],
});

3. SVG 파일 사용:

// src/assets/logo.svg
<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
  <path d="M12 2L2 12H6V22H18V12H22L12 2Z" fill="currentColor"/>
</svg>

// src/App.tsx
import React from 'react';
import LogoIcon from './assets/logo.svg?react'; // ?react 쿼리를 사용하여 SVG를 React 컴포넌트로 임포트

function App() {
  return (
    <div>
      <h1>My App</h1>
      <LogoIcon style={{ width: '50px', height: '50px', color: 'blue' }} />
    </div>
  );
}

export default App;

프록시 설정 (Proxy)

개발 중 백엔드 API 서버와 통신해야 할 때, CORS(Cross-Origin Resource Sharing) 문제를 피하기 위해 프록시 설정을 사용할 수 있습니다.

// vite.config.ts
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';

export default defineConfig({
  plugins: [react()],
  server: {
    proxy: {
      // '/api' 경로로 시작하는 요청을 'http://localhost:8080'으로 프록시합니다.
      '/api': {
        target: 'http://localhost:8080', // 백엔드 API 서버 주소
        changeOrigin: true, // 호스트 헤더를 대상 URL의 호스트로 변경
        rewrite: (path) => path.replace(/^\/api/, ''), // '/api' 접두사를 제거
      },
      // 다른 프록시 규칙 추가 가능
      '/socket.io': {
        target: 'ws://localhost:8080',
        ws: true, // 웹소켓 프록시 활성화
      },
    },
  },
});

이제 클라이언트 코드에서 /api/users로 요청하면, 실제로는 http://localhost:8080/users로 요청이 전달됩니다.

최적화 전략: 배포를 위한 Vite

Vite는 기본적으로 Rollup을 사용하여 강력한 최적화 기능을 제공하지만, 더 나은 성능을 위해 추가적인 빌드 최적화 전략을 적용할 수 있습니다.

Code Splitting (코드 분할)

Rollup은 기본적으로 코드 분할을 수행하지만, build.rollupOptions.output.manualChunks 옵션을 사용하여 수동으로 청크를 분할하여 초기 로드 시간을 더욱 최적화할 수 있습니다.

// vite.config.ts
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';

export default defineConfig({
  plugins: [react()],
  build: {
    rollupOptions: {
      output: {
        // vendor 청크를 수동으로 분리하여 재사용성을 높이고 캐싱 효율을 개선합니다.
        manualChunks(id) {
          if (id.includes('node_modules')) {
            return 'vendor'; // 모든 node_modules를 'vendor' 청크로 묶습니다.
          }
          // 특정 컴포넌트를 별도 청크로 분리하는 예시
          if (id.includes('src/components/LargeComponent')) {
            return 'large-component';
          }
        },
        // 청크 파일 이름 형식 설정
        entryFileNames: `assets/[name].[hash].js`,
        chunkFileNames: `assets/[name].[hash].js`,
        assetFileNames: `assets/[name].[hash].[ext]`,
      },
    },
    // 더 작은 청크를 생성하여 HTTP/2의 이점을 활용
    target: ['es2020', 'edge88', 'firefox78', 'chrome87', 'safari14'],
    // CSS 코드 분할 활성화
    cssCodeSplit: true,
  },
});

기타 최적화 고려 사항

• 정적 자산 압축: Nginx, Apache와 같은 웹 서버에서 Brotli 또는 Gzip 압축을 활성화하여 빌드된 정적 파일의 전송 크기를 줄일 수 있습니다.
• 이미지 최적화: vite-plugin-imagemin과 같은 플러그인을 사용하여 이미지 크기를 최적화하거나, WebP와 같은 현대적인 이미지 포맷을 활용합니다.
• Lazy Loading: React의 React.lazy()와 Suspense를 사용하여 컴포넌트를 필요할 때만 로드하도록 구현하여 초기 로드 성능을 더욱 향상시킬 수 있습니다.
• CDN 활용: 정적 자산을 CDN(Content Delivery Network)에 배포하여 사용자에게 더 빠르게 콘텐츠를 전달할 수 있습니다.

마무리

Vite는 모던 프론트엔드 개발의 복잡성을 해소하고 개발자 경험을 극대화하기 위해 탄생한 혁신적인 빌드 도구입니다. ESM 기반의 개발 서버, esbuild를 활용한 초고속 의존성 사전 번들링, 그리고 Rollup 기반의 최적화된 프로덕션 빌드 시스템은 Vite를 기존 빌드 도구들과 차별화하는 핵심적인 강점입니다.

이 가이드를 통해 Vite의 기본적인 사용법부터 React, TypeScript 프로젝트에서의 활용, 고급 설정 및 플러그인, 그리고 배포를 위한 최적화 전략까지 다양한 측면을 살펴보았습니다. Vite는 그 놀라운 속도와 간결한 설정으로 새로운 프로젝트뿐만 아니라 기존 프로젝트의 마이그레이션에도 충분히 고려해 볼 가치가 있습니다. 이제 Vite와 함께 더욱 빠르고 효율적인 프론트엔드 개발을 경험해 보시길 바랍니다.