Webpack 설정 생성기

webpack.config.js

webpack은 빌드할 때마다 이 폴더를 비웁니다.

TypeScript 없이 React를 쓰려면 JSX를 컴파일할 Babel이 필요합니다.

‘HTML 페이지’ 옵션이 필요합니다. 분리된 파일을 페이지에 자동으로 넣어 줍니다.

별칭이 필요 없으면 비워 두세요. @와 src를 지정하면 @/components/Button처럼 쓸 수 있습니다.

설정 생성

webpack.config.js를 기억에 의존해 작성하려면 output의 정확한 구조, 로더마다 test에 쓰는 정규식, 설치할 패키지를 모두 떠올려야 합니다. 이 생성기는 그 과정을 짧은 폼으로 바꿉니다. 순수 JavaScript, React, Vue 3 중 하나를 고르고 엔트리 파일, 출력 폴더, 모드를 정한 다음 TypeScript와 Babel부터 Sass, 이미지와 글꼴, HtmlWebpackPlugin, 개발 서버까지 필요한 항목을 체크하세요. 공식 문서를 따르는 webpack 5 설정, 실제로 쓰는 패키지만 담은 npm install 명령, TypeScript를 쓰는 경우 그에 맞는 tsconfig.json을 만들어 줍니다.

webpack 설정을 만드는 방법

  1. 1

    엔트리와 출력 지정

    엔트리 파일과 출력 폴더(기본값 `dist`)를 입력하세요. 제안되는 엔트리 파일은 프레임워크에 따라 바뀝니다. 예를 들어 TypeScript를 쓰는 React라면 `./src/index.tsx`입니다.

  2. 2

    모드와 프레임워크 선택

    `production` 또는 `development`를 고른 뒤 순수 JavaScript, React, Vue 3 중 하나를 선택하세요. 모드에 따라 파일 이름, 소스 맵 종류, CSS를 불러오는 방식이 정해집니다.

  3. 3

    로더와 플러그인 켜기

    TypeScript, Babel, CSS, Sass, 이미지와 글꼴, `HtmlWebpackPlugin`, 개발 서버, 소스 맵, 라이브러리 코드 분리, 임포트 별칭을 필요한 만큼 켜세요.

  4. 4

    파일 복사

    ‘설정 생성’을 누른 다음 `webpack.config.js`, `npm install` 명령, TypeScript를 쓰는 경우 `tsconfig.json`을 프로젝트 루트에 복사하세요.

기본 출력

기본 설정(프로덕션 모드, 순수 JavaScript, Babel, CSS, 이미지와 글꼴, HtmlWebpackPlugin, 개발 서버, 소스 맵)에서는 다음과 같은 설정이 만들어집니다.

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const MiniCssExtractPlugin = require('mini-css-extract-plugin');

module.exports = {
  mode: 'production',
  entry: './src/index.js',
  output: {
    path: path.resolve(__dirname, 'dist'),
    filename: '[name].[contenthash].js',
    clean: true,
  },
  devtool: 'source-map',
  module: {
    rules: [
      {
        test: /\.(?:js|mjs|cjs)$/,
        exclude: /node_modules/,
        use: {
          loader: 'babel-loader',
          options: {
            targets: 'defaults',
            presets: [['@babel/preset-env']],
          },
        },
      },
      {
        test: /\.css$/i,
        use: [MiniCssExtractPlugin.loader, 'css-loader'],
      },
      {
        test: /\.(png|svg|jpg|jpeg|gif|webp|avif)$/i,
        type: 'asset/resource',
      },
      {
        test: /\.(woff|woff2|eot|ttf|otf)$/i,
        type: 'asset/resource',
      },
    ],
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: './src/index.html',
    }),
    new MiniCssExtractPlugin({
      filename: '[name].[contenthash].css',
    }),
  ],
  devServer: {
    port: 3000,
    hot: true,
  },
};

이 패키지들만 설치하는 명령도 함께 제공합니다.

npm install -D webpack webpack-cli webpack-dev-server html-webpack-plugin babel-loader @babel/core @babel/preset-env css-loader mini-css-extract-plugin

각 옵션이 추가하는 내용

옵션 설정에 추가되는 내용
엔트리 파일 entry 값입니다. src/index.js 같은 경로에는 앞에 ./가 붙습니다. webpack은 접두사 없는 경로를 node_modules에서 찾기 때문입니다.
출력 폴더 path.resolve(__dirname, 'dist')로 계산한 output.path와 output.clean: true입니다.
모드 mode: 'production' 또는 mode: 'development'입니다. 프로덕션에서는 HtmlWebpackPlugin이 페이지를 만들 때 파일 이름이 [name].[contenthash].js가 되고, 개발 모드에서는 [name].js가 됩니다.
프레임워크 React는 @babel/preset-react를 추가하고, TypeScript를 쓰면 tsconfig.json에 "jsx": "react-jsx"를 넣습니다. Vue 3은 vue-loader, VueLoaderPlugin, 그리고 DefinePlugin을 통한 Vue 기능 플래그를 추가합니다.
TypeScript .ts와 .tsx용 ts-loader 규칙, resolve.extensions의 해당 확장자, tsconfig.json입니다.
Babel @babel/preset-env와 targets: 'defaults'를 쓰는 babel-loader 규칙입니다.
CSS와 Sass 개발 모드에서는 style-loader, 프로덕션에서는 MiniCssExtractPlugin을 쓰고 그 뒤에 css-loader가 옵니다. Sass를 켜면 sass-loader와 sass 패키지가 추가됩니다.
이미지와 글꼴 type: 'asset/resource'를 쓰는 에셋 모듈 규칙 두 개입니다. webpack 5에서 file-loader와 url-loader를 대신합니다.
HTML 페이지 엔트리 파일 옆의 index.html을 템플릿으로 쓰는 HtmlWebpackPlugin입니다.
개발 서버 포트 3000에서 핫 리로드를 켠 devServer 블록입니다. React나 Vue를 쓰면 클라이언트 측 라우트가 열리도록 historyApiFallback과 publicPath: '/'가 추가됩니다.
소스 맵 프로덕션에서는 devtool: 'source-map', 개발 모드에서는 'eval-source-map'입니다.
라이브러리 코드 분리 chunks: 'all'을 지정한 optimization.splitChunks입니다.
임포트 별칭 '@': path.resolve(__dirname, 'src') 같은 resolve.alias 항목입니다. TypeScript를 쓰면 tsconfig.json의 paths에도 반영됩니다.

도구가 대신 정하는 것

  • 안전한 출력 폴더. output.clean은 빌드할 때마다 출력 폴더를 비우므로 src, public, node_modules, 프로젝트 루트, 엔트리 파일이 들어 있는 폴더는 받아들이지 않습니다.
  • CSS를 불러오는 방식은 하나만. 플러그인 문서의 경고대로 style-loader와 MiniCssExtractPlugin을 함께 쓰지 않습니다.
  • 해시는 생성된 페이지가 있을 때만. 직접 작성한 index.html은 해시가 붙은 파일 이름을 가리킬 수 없습니다. 그래서 HtmlWebpackPlugin 없이는 파일 이름이 [name].js가 되고, 개발 서버는 ./public에서 페이지를 제공합니다.
  • TypeScript를 쓰는 Vue는 빌드 중 타입 검사를 건너뜁니다. vue-loader 예제처럼 ts-loader를 transpileOnly: true로 실행합니다. 타입은 에디터나 vue-tsc로 확인하세요.

더 확장하기

생성된 파일은 출발점입니다. 흔히 직접 추가하는 항목은 Autoprefixer나 Tailwind CSS를 위한 postcss-loader, 더 빠른 타입 검사를 위한 fork-ts-checker-webpack-plugin, 정적 파일을 위한 copy-webpack-plugin, 로컬 API를 위한 devServer의 proxy 항목입니다.

자주 묻는 질문

webpack 5와 webpack-dev-server 5 또는 6용입니다. 출력에는 output.clean, [contenthash]가 붙은 파일 이름, 에셋 모듈, '...'를 포함한 resolve.extensions를 쓰므로 정리용 플러그인이나 file-loader, url-loader가 필요 없습니다.

아니요. webpack 설정은 항상 JavaScript 파일인 webpack.config.js입니다. TypeScript 옵션은 ts-loader 규칙을 추가하고 소스 코드용 tsconfig.json을 제공하지만, webpack 설정 파일 자체의 형식은 바꾸지 않습니다.

HTML 페이지 옵션을 켜면 HtmlWebpackPlugin이 엔트리 파일 옆의 index.html을 템플릿으로 사용합니다. 이 파일을 만들거나(React와 Vue에는 <div id="root"></div>나 <div id="app"></div>처럼 앱을 마운트할 요소가 필요합니다) 옵션을 끄세요.

생성된 devServer 블록은 포트 3000에서 핫 리로드를 사용합니다. 다른 포트가 필요하면 복사한 파일에서 port 값을 바꾸세요.

네. 각 옵션이 자체 규칙(.ts와 .tsx에는 ts-loader, .js에는 babel-loader)을 추가하므로 둘 중 하나만 쓰거나 둘 다 쓸 수 있습니다. TypeScript 없이 React를 쓰려면 JSX를 컴파일할 Babel이 필요하므로, 이 경우 도구가 Babel을 켠 상태로 둡니다.

관련 도구

이 도구는 다른 언어로도 제공됩니다