esbuild 완벽 가이드 | 초고속 번들러·TypeScript·Plugins·실전 활용

2026년 4월 7일 · 11분 읽기 · 수정 2026년 4월 7일 중급

이 글의 핵심

esbuild로 초고속 번들링을 구현하는 완벽 가이드입니다. Go 기반 성능, TypeScript, JSX, Plugins, Watch Mode까지 실전 예제로 정리했습니다.

실무 경험 공유: Webpack에서 esbuild로 전환하면서, 빌드 시간이 10분에서 10초로 단축된 경험을 공유합니다.

들어가며: “빌드가 너무 느려요”

실무 문제 시나리오

시나리오 1: TypeScript 빌드가 느려요
tsc는 느립니다. esbuild는 100배 빠릅니다.

시나리오 2: 번들링이 느려요
Webpack은 느립니다. esbuild는 10~100배 빠릅니다.

시나리오 3: 빠른 피드백이 필요해요
느린 빌드는 생산성을 떨어뜨립니다. esbuild는 즉시 피드백을 제공합니다.

1. esbuild란?

핵심 특징

esbuild는 Go로 작성된 초고속 JavaScript 번들러입니다.

주요 장점:

초고속: 10~100배 빠름
TypeScript: 네이티브 지원
JSX: 네이티브 지원
Tree Shaking: 자동
Source Maps: 지원

2. 설치 및 기본 사용

설치

npm install -D esbuild

CLI

# 번들링
esbuild src/index.ts --bundle --outfile=dist/bundle.js

# Minify
esbuild src/index.ts --bundle --minify --outfile=dist/bundle.js

# Watch
esbuild src/index.ts --bundle --watch --outfile=dist/bundle.js

3. Build API

// build.js
const esbuild = require('esbuild');

esbuild.build({
  entryPoints: ['src/index.ts'],
  bundle: true,
  minify: true,
  sourcemap: true,
  target: ['es2020'],
  outfile: 'dist/bundle.js',
}).catch(() => process.exit(1));

package.json

{
  "scripts": {
    "build": "node build.js"
  }
}

4. TypeScript

esbuild.build({
  entryPoints: ['src/index.ts'],
  bundle: true,
  outfile: 'dist/bundle.js',
  loader: {
    '.ts': 'ts',
    '.tsx': 'tsx',
  },
});

5. React/JSX

esbuild.build({
  entryPoints: ['src/index.tsx'],
  bundle: true,
  outfile: 'dist/bundle.js',
  loader: {
    '.tsx': 'tsx',
  },
  jsxFactory: 'React.createElement',
  jsxFragment: 'React.Fragment',
});

6. Watch Mode

const ctx = await esbuild.context({
  entryPoints: ['src/index.ts'],
  bundle: true,
  outfile: 'dist/bundle.js',
});

await ctx.watch();

console.log('Watching...');

7. Dev Server

const ctx = await esbuild.context({
  entryPoints: ['src/index.ts'],
  bundle: true,
  outfile: 'dist/bundle.js',
});

await ctx.serve({
  servedir: 'public',
  port: 3000,
});

console.log('Server running on http://localhost:3000');

8. Plugins

const envPlugin = {
  name: 'env',
  setup(build) {
    build.onResolve({ filter: /^env$/ }, (args) => ({
      path: args.path,
      namespace: 'env-ns',
    }));

    build.onLoad({ filter: /.*/, namespace: 'env-ns' }, () => ({
      contents: JSON.stringify(process.env),
      loader: 'json',
    }));
  },
};

esbuild.build({
  entryPoints: ['src/index.ts'],
  bundle: true,
  plugins: [envPlugin],
  outfile: 'dist/bundle.js',
});

9. 실전 예제: React 프로젝트

// build.js
const esbuild = require('esbuild');
const { copy } = require('esbuild-plugin-copy');

const isProduction = process.env.NODE_ENV === 'production';

esbuild.build({
  entryPoints: ['src/index.tsx'],
  bundle: true,
  minify: isProduction,
  sourcemap: !isProduction,
  target: ['es2020'],
  outfile: 'dist/bundle.js',
  loader: {
    '.tsx': 'tsx',
    '.ts': 'ts',
  },
  define: {
    'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV),
  },
  plugins: [
    copy({
      resolveFrom: 'cwd',
      assets: {
        from: ['./public/**/*'],
        to: ['./dist'],
      },
    }),
  ],
}).catch(() => process.exit(1));

정리 및 체크리스트

핵심 요약

esbuild: 초고속 번들러
Go 기반: 10~100배 빠름
TypeScript: 네이티브 지원
JSX: 네이티브 지원
Tree Shaking: 자동
Plugins: 확장 가능

구현 체크리스트

같이 보면 좋은 글

Vite 완벽 가이드
Webpack 완벽 가이드
Bun 완벽 가이드

이 글에서 다루는 키워드

esbuild, Bundler, Build Tools, TypeScript, Go, Performance, Frontend

자주 묻는 질문 (FAQ)

Q. Webpack을 완전히 대체할 수 있나요?

A. 간단한 프로젝트는 가능하지만, 복잡한 설정이 필요하면 Webpack이 더 적합합니다.

Q. Vite와 비교하면 어떤가요?

A. Vite는 esbuild를 내부적으로 사용합니다. Vite가 더 편리하고 esbuild가 더 빠릅니다.

Q. 타입 체크를 하나요?

A. 아니요, 타입을 제거만 합니다. tsc로 별도로 타입 체크를 해야 합니다.

Q. 프로덕션에서 사용해도 되나요?

A. 네, Vite, Remix 등이 esbuild를 사용하고 있습니다.