Webpack 설정 생성기
webpack은 빌드할 때마다 이 폴더를 비웁니다.
별칭이 필요 없으면 비워 두세요. @와 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
엔트리와 출력 지정
엔트리 파일과 출력 폴더(기본값 `dist`)를 입력하세요. 제안되는 엔트리 파일은 프레임워크에 따라 바뀝니다. 예를 들어 TypeScript를 쓰는 React라면 `./src/index.tsx`입니다.
-
2
모드와 프레임워크 선택
`production` 또는 `development`를 고른 뒤 순수 JavaScript, React, Vue 3 중 하나를 선택하세요. 모드에 따라 파일 이름, 소스 맵 종류, CSS를 불러오는 방식이 정해집니다.
-
3
로더와 플러그인 켜기
TypeScript, Babel, CSS, Sass, 이미지와 글꼴, `HtmlWebpackPlugin`, 개발 서버, 소스 맵, 라이브러리 코드 분리, 임포트 별칭을 필요한 만큼 켜세요.
-
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을 켠 상태로 둡니다.
관련 도구
보색 찾기
어떤 입력에 대해서도 보색을 찾습니다. HSL 반대 색, 분할 보색 쌍, 그리고 접근성 있는 조합 제안을 반환합니다.
색상 혼합기
두 HEX 색상을 2-20개의 균등한 색상 견본으로 섞습니다. 양 끝 색상을 포함해 각 중간 색상을 대문자 HEX 코드로 확인하세요.
PHP 포매터
간단한 PHP 코드에 줄바꿈과 2칸 또는 4칸 들여쓰기를 추가합니다. 결과를 반드시 검토하세요. PHP 파서나 PSR-12 적용 도구가 아닙니다.
OpenAPI 검증기
OpenAPI 또는 Swagger 문서를 JSON이나 YAML로 붙여넣고 핵심 구조를 점검하세요: 버전 필드, info 객체, paths를 명확한 오류와 경고와 함께 확인합니다.
CSS 로딩 애니메이션 생성기
순수 CSS로 원형 스피너를 만듭니다. 지름, 테두리 두께, 포인트 색상, 회전 속도를 설정하고 미리 보기를 확인한 뒤 바로 쓸 수 있는 CSS를 복사하세요. SVG도 자바스크립트도 필요 없습니다.
텍스트 파일 인코딩 변환기
깨진 문자를 고치기 위해 텍스트를 UTF-8, UTF-16, Latin-1, Windows-1252 등 여러 인코딩 사이에서 변환하세요.
이 도구는 다른 언어로도 제공됩니다
- Webpack-configuratiegenerator [NL]
- Générateur de configuration Webpack [FR]
- Generator Konfigurasi Webpack [ID]
- Generador de Configuración de Webpack [ES]
- Webpack-Konfigurationsgenerator [DE]
- Gerador de Configuração Webpack [PT]
- ตัวสร้างการตั้งค่า Webpack [TH]
- Webpack設定ジェネレーター [JA]
- Trình tạo cấu hình webpack [VI]
- Webpack-konfigurationsgenerator [SV]
- مولّد إعدادات Webpack [AR]
- Generator konfiguracji webpack [PL]
- Webpack Config Generator [EN]
- Generatore di Configurazione Webpack [IT]
- Генератор конфигурации webpack [RU]
- Webpack Yapılandırma Oluşturucu [TR]
- Webpack 配置生成器 [ZH]