Generator Konfigurasi Webpack

webpack.config.js

Webpack mengosongkan folder ini setiap kali build.

React tanpa TypeScript memerlukan Babel untuk mengompilasi JSX.

Memerlukan opsi “Halaman HTML”, yang menambahkan file terpisah ke halaman untuk Anda.

Kosongkan alias jika tidak diperlukan. Dengan @ dan src, Anda dapat menulis @/components/Button.

Buat konfigurasi

Menulis webpack.config.js dari ingatan berarti Anda harus mengingat struktur output yang tepat, regex test untuk setiap loader, dan paket apa saja yang perlu diinstal. Generator ini mengubah semua itu menjadi formulir singkat: pilih JavaScript biasa, React, atau Vue 3, atur file entry, folder output, dan mode, lalu centang yang Anda perlukan, mulai dari TypeScript dan Babel hingga Sass, gambar dan font, HtmlWebpackPlugin, serta server pengembangan. Hasilnya adalah konfigurasi webpack 5 yang mengikuti dokumentasi resmi, baris npm install untuk paket yang benar-benar dipakai, dan, jika memakai TypeScript, tsconfig.json yang sesuai.

Cara membuat konfigurasi webpack

  1. 1

    Atur entry dan output

    Ketik file entry dan folder output Anda (bawaan: `dist`). File entry yang disarankan menyesuaikan framework, misalnya `./src/index.tsx` untuk React dengan TypeScript.

  2. 2

    Pilih mode dan framework

    Pilih `production` atau `development`, lalu JavaScript biasa, React, atau Vue 3. Mode menentukan nama file, jenis source map, dan cara CSS dimuat.

  3. 3

    Aktifkan loader dan plugin

    Aktifkan sesuai kebutuhan: TypeScript, Babel, CSS, Sass, gambar dan font, `HtmlWebpackPlugin`, server pengembangan, source map, pemisahan kode vendor, dan alias impor.

  4. 4

    Salin file

    Klik “Buat konfigurasi”, lalu salin `webpack.config.js`, baris `npm install`, dan, jika memakai TypeScript, `tsconfig.json` ke root proyek Anda.

Hasil bawaan

Dengan pengaturan bawaan (mode produksi, JavaScript biasa, Babel, CSS, gambar dan font, HtmlWebpackPlugin, server pengembangan, dan source map), generator menulis:

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,
  },
};

Anda juga mendapat baris instalasi untuk paket-paket tersebut, tidak lebih:

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

Apa yang ditulis setiap opsi

Opsi Yang ditambahkan ke konfigurasi
File entry Nilai entry. Path seperti src/index.js diberi awalan ./, karena webpack mencari path tanpa awalan di node_modules.
Folder output output.path, di-resolve dengan path.resolve(__dirname, 'dist'), ditambah output.clean: true.
Mode mode: 'production' atau mode: 'development'. Pada produksi, nama file menjadi [name].[contenthash].js saat HtmlWebpackPlugin menulis halaman; pada pengembangan, [name].js.
Framework React menambahkan @babel/preset-react, atau "jsx": "react-jsx" di tsconfig.json jika memakai TypeScript. Vue 3 menambahkan vue-loader, VueLoaderPlugin, dan feature flag Vue melalui DefinePlugin.
TypeScript Aturan ts-loader untuk .ts dan .tsx, ekstensi tersebut di resolve.extensions, dan sebuah tsconfig.json.
Babel Aturan babel-loader dengan @babel/preset-env dan targets: 'defaults'.
CSS dan Sass style-loader pada pengembangan atau MiniCssExtractPlugin pada produksi, lalu css-loader; Sass menambahkan sass-loader dan paket sass.
Gambar dan font Dua aturan asset module dengan type: 'asset/resource', pengganti file-loader dan url-loader di webpack 5.
Halaman HTML HtmlWebpackPlugin dengan template index.html di samping file entry Anda.
Server pengembangan Blok devServer di port 3000 dengan hot reload. Dengan React atau Vue, ditambahkan historyApiFallback dan publicPath: '/' agar rute sisi klien bisa dimuat.
Source map devtool: 'source-map' pada produksi dan 'eval-source-map' pada pengembangan.
Pisahkan kode vendor optimization.splitChunks dengan chunks: 'all'.
Alias impor Entri resolve.alias seperti '@': path.resolve(__dirname, 'src'), yang juga ditulis di paths pada tsconfig.json jika memakai TypeScript.

Yang diputuskan alat ini untuk Anda

  • Folder output yang aman. output.clean mengosongkan folder output setiap kali build, jadi alat ini menolak src, public, node_modules, root proyek, dan folder apa pun yang berisi file entry Anda.
  • Satu cara memuat CSS. style-loader dan MiniCssExtractPlugin tidak pernah digabungkan, sesuai peringatan di dokumentasi plugin tersebut.
  • Hash hanya jika halaman dibuat otomatis. index.html yang ditulis manual tidak bisa merujuk ke nama file ber-hash, jadi tanpa HtmlWebpackPlugin file diberi nama [name].js dan server pengembangan menyajikan halaman Anda dari ./public.
  • Vue dengan TypeScript tidak memeriksa tipe saat build. ts-loader berjalan dengan transpileOnly: true, seperti pada contoh vue-loader; periksa tipe di editor Anda atau dengan vue-tsc.

Mengembangkannya lebih lanjut

File yang dihasilkan adalah titik awal. Tambahan manual yang umum: postcss-loader untuk Autoprefixer atau Tailwind CSS, fork-ts-checker-webpack-plugin untuk pemeriksaan tipe yang lebih cepat, copy-webpack-plugin untuk file statis, dan entri proxy di devServer untuk API lokal.

Pertanyaan yang Sering Diajukan

Untuk webpack 5 dan webpack-dev-server 5 atau 6. Hasilnya memakai output.clean, nama file dengan [contenthash], asset module, dan resolve.extensions dengan '...', jadi Anda tidak memerlukan plugin pembersih, file-loader, atau url-loader.

Tidak, konfigurasi webpack selalu berupa file JavaScript webpack.config.js. Opsi TypeScript menambahkan aturan ts-loader dan memberi Anda tsconfig.json untuk kode sumber; opsi ini tidak mengubah format konfigurasi webpack itu sendiri.

Saat opsi Halaman HTML aktif, HtmlWebpackPlugin memakai template index.html di samping file entry Anda. Buat file itu (React dan Vue memerlukan elemen tempat aplikasi dipasang, seperti <div id="root"></div> atau <div id="app"></div>) atau matikan opsinya.

Blok devServer yang dihasilkan memakai port 3000 dengan hot reload. Ubah nilai port di file yang Anda salin jika memerlukan port lain.

Bisa. Setiap opsi menambahkan aturannya sendiri (ts-loader untuk .ts dan .tsx, babel-loader untuk .js), jadi Anda bisa memakai salah satu atau keduanya. React tanpa TypeScript memerlukan Babel untuk mengompilasi JSX, sehingga dalam kasus itu alat ini tetap mengaktifkan Babel.

Alat Terkait

Alat ini tersedia dalam bahasa lain