Генератор конфигурации webpack

webpack.config.js

Webpack очищает эту папку при каждой сборке.

Для React без TypeScript нужен Babel, чтобы компилировать JSX.

Нужна опция «HTML-страница»: она сама подключает вынесенные файлы к странице.

Оставьте алиас пустым, если он не нужен. С @ и 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. 1

    Укажите вход и выход

    Введите входной файл и выходную папку (по умолчанию `dist`). Предлагаемый входной файл зависит от фреймворка, например `./src/index.tsx` для React с TypeScript.

  2. 2

    Выберите режим и фреймворк

    Выберите `production` или `development`, затем чистый JavaScript, React или Vue 3. От режима зависят имена файлов, тип карт исходников и способ загрузки CSS.

  3. 3

    Включите загрузчики и плагины

    Включите нужное: TypeScript, Babel, CSS, Sass, изображения и шрифты, `HtmlWebpackPlugin`, dev-сервер, карты исходников, вынос кода библиотек и алиас импорта.

  4. 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, с понятными ошибками и предупреждениями.

Инструмент доступен на других языках