Генератор конфигурации webpack
Webpack очищает эту папку при каждой сборке.
Оставьте алиас пустым, если он не нужен. С @ и src можно писать @/components/Button.
Чтобы написать webpack.config.js по памяти, нужно помнить точную структуру output, регулярное выражение test для каждого загрузчика и список пакетов для установки. Этот генератор превращает всё это в короткую форму: выберите чистый JavaScript, React или Vue 3, укажите входной файл, выходную папку и режим, затем отметьте нужное, от TypeScript и Babel до Sass, изображений и шрифтов, HtmlWebpackPlugin и dev-сервера. Он создаёт конфигурацию webpack 5 по официальной документации, команду npm install ровно для тех пакетов, которые в ней используются, и, если выбран TypeScript, подходящий tsconfig.json.
Как создать конфигурацию webpack
-
1
Укажите вход и выход
Введите входной файл и выходную папку (по умолчанию `dist`). Предлагаемый входной файл зависит от фреймворка, например `./src/index.tsx` для React с TypeScript.
-
2
Выберите режим и фреймворк
Выберите `production` или `development`, затем чистый JavaScript, React или Vue 3. От режима зависят имена файлов, тип карт исходников и способ загрузки CSS.
-
3
Включите загрузчики и плагины
Включите нужное: TypeScript, Babel, CSS, Sass, изображения и шрифты, `HtmlWebpackPlugin`, dev-сервер, карты исходников, вынос кода библиотек и алиас импорта.
-
4
Скопируйте файлы
Нажмите «Создать конфигурацию», затем скопируйте `webpack.config.js`, команду `npm install` и, если выбран TypeScript, `tsconfig.json` в корень проекта.
Результат по умолчанию
С настройками по умолчанию (режим продакшен, чистый JavaScript, Babel, CSS, изображения и шрифты, HtmlWebpackPlugin, dev-сервер и карты исходников) генератор пишет:
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. |
| Выходная папка | output.path, вычисленный через path.resolve(__dirname, 'dist'), и output.clean: true. |
| Режим | mode: 'production' или mode: 'development'. В продакшене файлы называются [name].[contenthash].js, если страницу пишет HtmlWebpackPlugin; в разработке [name].js. |
| Фреймворк | React добавляет @babel/preset-react, а с TypeScript "jsx": "react-jsx" в tsconfig.json. Vue 3 добавляет vue-loader, VueLoaderPlugin и флаги возможностей Vue через DefinePlugin. |
| TypeScript | Правило ts-loader для .ts и .tsx, эти расширения в resolve.extensions и tsconfig.json. |
| Babel | Правило babel-loader с @babel/preset-env и targets: 'defaults'. |
| CSS и Sass | style-loader в разработке или MiniCssExtractPlugin в продакшене, затем css-loader; Sass добавляет sass-loader и пакет sass. |
| Изображения и шрифты | Два правила asset modules с type: 'asset/resource', которые в webpack 5 заменяют file-loader и url-loader. |
| HTML-страница | HtmlWebpackPlugin с шаблоном index.html рядом с входным файлом. |
| Dev-сервер | Блок devServer на порту 3000 с горячей перезагрузкой. Для React или Vue добавляются historyApiFallback и publicPath: '/', чтобы открывались клиентские маршруты. |
| Карты исходников | devtool: 'source-map' в продакшене и 'eval-source-map' в разработке. |
| Вынести код библиотек | optimization.splitChunks с chunks: 'all'. |
| Алиас импорта | Запись resolve.alias вида '@': path.resolve(__dirname, 'src'); с TypeScript она повторяется в paths файла tsconfig.json. |
Что инструмент решает за вас
- Безопасная выходная папка.
output.cleanочищает выходную папку при каждой сборке, поэтому инструмент не принимаетsrc,public,node_modules, корень проекта и любую папку, в которой лежит входной файл. - Один способ загрузки CSS.
style-loaderиMiniCssExtractPluginникогда не используются вместе, как и предупреждает документация плагина. - Хеши только со сгенерированной страницей. Написанный вручную
index.htmlне может ссылаться на имя файла с хешем, поэтому безHtmlWebpackPluginфайлы называются[name].js, а dev-сервер отдаёт вашу страницу из./public. - Vue с TypeScript не проверяет типы при сборке.
ts-loaderработает сtranspileOnly: true, как в примереvue-loader; проверяйте типы в редакторе или с помощьюvue-tsc.
Что можно добавить
Сгенерированные файлы служат отправной точкой. Частые ручные дополнения: postcss-loader для Autoprefixer или Tailwind CSS, fork-ts-checker-webpack-plugin для более быстрой проверки типов, copy-webpack-plugin для статических файлов и запись proxy в devServer для локального API.
Часто задаваемые вопросы
Для webpack 5 и webpack-dev-server 5 или 6. В результате используются output.clean, имена файлов с [contenthash], asset modules и 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-loader для .ts и .tsx, babel-loader для .js), так что можно использовать одно, другое или оба. Для React без TypeScript нужен Babel, чтобы компилировать JSX, поэтому в этом случае инструмент оставляет Babel включённым.
Сопутствующие инструменты
Генератор градиентных обоев
Создавайте размытые трёхцветные градиентные обои для ноутбука, телефона или фона в Zoom. Задавайте угол и степень размытия вручную или случайным образом.
Генератор вымышленных телефонных номеров
Создавайте до 50 вымышленных номеров из официально зарезервированных диапазонов пяти стран.
Генератор случайных букв
Генерируйте случайные буквы A-Z. Выберите количество, верхний или нижний регистр либо смешанный вариант для игр, заданий и уроков.
Проверка телефонных номеров
Проверьте структуру номера по стране и получите регион, тип, форматы E.164, международный, национальный и RFC 3966.
Конвертер размера файлов
Преобразуйте значения между байтами, КБ, МБ, ГБ, ТБ и двоичными единицами IEC (KiB, MiB, GiB, TiB), свободно сочетая десятичные и двоичные единицы.
Валидатор OpenAPI
Вставьте документ OpenAPI или Swagger в JSON или YAML и проверьте его основную структуру: поле версии, объект info и paths, с понятными ошибками и предупреждениями.
Инструмент доступен на других языках
- Webpack-Konfigurationsgenerator [DE]
- مولّد إعدادات Webpack [AR]
- Generator konfiguracji webpack [PL]
- ตัวสร้างการตั้งค่า Webpack [TH]
- Générateur de configuration Webpack [FR]
- Generator Konfigurasi Webpack [ID]
- Gerador de Configuração Webpack [PT]
- Trình tạo cấu hình webpack [VI]
- Generador de Configuración de Webpack [ES]
- Webpack設定ジェネレーター [JA]
- Webpack 설정 생성기 [KO]
- Webpack-konfigurationsgenerator [SV]
- Webpack-configuratiegenerator [NL]
- Generatore di Configurazione Webpack [IT]
- Webpack Yapılandırma Oluşturucu [TR]
- Webpack 配置生成器 [ZH]
- Webpack Config Generator [EN]