ตัวสร้างการตั้งค่า Webpack
Webpack จะล้างโฟลเดอร์นี้ทุกครั้งที่ build
เว้นช่อง alias ว่างไว้หากไม่ต้องการใช้ ถ้าตั้ง @ กับ src คุณจะเขียน @/components/Button ได้
การเขียน webpack.config.js จากความจำหมายถึงต้องจำโครงสร้างของ output ให้ถูกต้อง จำ regex ใน test ของ loader แต่ละตัว และจำว่าต้องติดตั้งแพ็กเกจอะไรบ้าง เครื่องมือนี้เปลี่ยนทั้งหมดให้เป็นแบบฟอร์มสั้นๆ เลือก JavaScript ล้วน React หรือ Vue 3 กำหนดไฟล์ entry โฟลเดอร์เอาต์พุต และโหมด แล้วติ๊กสิ่งที่ต้องการ ตั้งแต่ TypeScript และ Babel ไปจนถึง Sass รูปภาพและฟอนต์ HtmlWebpackPlugin และเซิร์ฟเวอร์สำหรับพัฒนา เครื่องมือจะเขียนคอนฟิก webpack 5 ตามเอกสารทางการ พร้อมคำสั่ง npm install สำหรับแพ็กเกจที่ใช้จริงเท่านั้น และถ้าเลือก TypeScript ก็จะได้ tsconfig.json ที่เข้าชุดกันด้วย
วิธีสร้างคอนฟิก webpack
-
1
กำหนด entry และเอาต์พุต
พิมพ์ไฟล์ entry และโฟลเดอร์เอาต์พุต (ค่าเริ่มต้นคือ `dist`) ไฟล์ entry ที่แนะนำจะเปลี่ยนตามเฟรมเวิร์ก เช่น `./src/index.tsx` สำหรับ React ที่ใช้ TypeScript
-
2
เลือกโหมดและเฟรมเวิร์ก
เลือก `production` หรือ `development` แล้วเลือก JavaScript ล้วน React หรือ Vue 3 โหมดจะกำหนดชื่อไฟล์ ประเภทของ source map และวิธีโหลด CSS
-
3
เปิด loader และปลั๊กอิน
เปิดสิ่งที่ต้องการ ได้แก่ TypeScript, Babel, CSS, Sass, รูปภาพและฟอนต์, `HtmlWebpackPlugin`, เซิร์ฟเวอร์สำหรับพัฒนา, source map, การแยกโค้ดไลบรารี และ alias สำหรับ import
-
4
คัดลอกไฟล์
กด “สร้างคอนฟิก” แล้วคัดลอก `webpack.config.js` คำสั่ง `npm install` และ `tsconfig.json` (เมื่อใช้ TypeScript) ไปไว้ที่โฟลเดอร์รากของโปรเจกต์
ผลลัพธ์ตามค่าเริ่มต้น
เมื่อใช้ค่าเริ่มต้น (โหมด production, JavaScript ล้วน, Babel, CSS, รูปภาพและฟอนต์, HtmlWebpackPlugin, เซิร์ฟเวอร์สำหรับพัฒนา และ source map) เครื่องมือจะเขียนคอนฟิกดังนี้
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 | ค่าของ entry พาธอย่าง src/index.js จะถูกเติม ./ ไว้ข้างหน้า เพราะ webpack จะค้นหาพาธที่ไม่มีคำนำหน้าใน node_modules |
| โฟลเดอร์เอาต์พุต | output.path ที่คำนวณด้วย path.resolve(__dirname, 'dist') พร้อม output.clean: true |
| โหมด | mode: 'production' หรือ mode: 'development' ในโหมด production ไฟล์จะชื่อ [name].[contenthash].js เมื่อ HtmlWebpackPlugin เป็นผู้เขียนหน้าเว็บ ส่วนโหมด development ใช้ [name].js |
| เฟรมเวิร์ก | React จะเพิ่ม @babel/preset-react หรือเพิ่ม "jsx": "react-jsx" ใน tsconfig.json เมื่อใช้ TypeScript ส่วน 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 ในโหมด development หรือ MiniCssExtractPlugin ในโหมด production ตามด้วย css-loader ส่วน Sass จะเพิ่ม sass-loader และแพ็กเกจ sass |
| รูปภาพและฟอนต์ | กฎ asset module สองข้อที่ใช้ type: 'asset/resource' ซึ่งใน webpack 5 ใช้แทน file-loader และ url-loader |
| หน้า HTML | HtmlWebpackPlugin พร้อมเทมเพลต index.html ที่วางไว้ข้างไฟล์ entry |
| เซิร์ฟเวอร์สำหรับพัฒนา | บล็อก devServer ที่พอร์ต 3000 พร้อม hot reload เมื่อใช้ React หรือ Vue จะเพิ่ม historyApiFallback และ publicPath: '/' เพื่อให้เส้นทางฝั่งไคลเอนต์โหลดได้ |
| Source map | devtool: 'source-map' ในโหมด production และ 'eval-source-map' ในโหมด development |
| แยกโค้ดไลบรารี | optimization.splitChunks พร้อม chunks: 'all' |
| Alias สำหรับ import | รายการใน resolve.alias เช่น '@': path.resolve(__dirname, 'src') และเมื่อใช้ TypeScript จะเพิ่มลงใน paths ของ tsconfig.json ด้วย |
สิ่งที่เครื่องมือตัดสินใจให้คุณ
- โฟลเดอร์เอาต์พุตที่ปลอดภัย
output.cleanจะล้างโฟลเดอร์เอาต์พุตทุกครั้งที่ build เครื่องมือจึงไม่รับsrc,public,node_modules, โฟลเดอร์รากของโปรเจกต์ และโฟลเดอร์ใดก็ตามที่มีไฟล์ entry ของคุณอยู่ - โหลด CSS ด้วยวิธีเดียว
style-loaderกับMiniCssExtractPluginจะไม่ถูกใช้ร่วมกัน ตามคำเตือนในเอกสารของปลั๊กอิน - ใส่แฮชเฉพาะเมื่อมีหน้าที่สร้างให้อัตโนมัติ ไฟล์
index.htmlที่เขียนเองไม่สามารถอ้างถึงชื่อไฟล์ที่มีแฮชได้ ดังนั้นเมื่อไม่ใช้HtmlWebpackPluginไฟล์จะชื่อ[name].jsและเซิร์ฟเวอร์สำหรับพัฒนาจะเปิดหน้าเว็บของคุณจาก./public - Vue ที่ใช้ TypeScript จะข้ามการตรวจชนิดข้อมูลตอน build
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 module และ resolve.extensions ที่มี '...' จึงไม่ต้องใช้ปลั๊กอินสำหรับล้างโฟลเดอร์ file-loader หรือ url-loader
ไม่ได้ คอนฟิก webpack จะเป็นไฟล์ JavaScript ชื่อ webpack.config.js เสมอ ตัวเลือก TypeScript จะเพิ่มกฎ ts-loader และให้ tsconfig.json สำหรับซอร์สโค้ดของคุณ แต่ไม่ได้เปลี่ยนรูปแบบของคอนฟิก webpack เอง
เมื่อเปิดตัวเลือกหน้า HTML ไว้ HtmlWebpackPlugin จะใช้เทมเพลต index.html ที่อยู่ข้างไฟล์ entry ให้สร้างไฟล์นั้นขึ้นมา (React และ Vue ต้องมีอิลิเมนต์สำหรับเมานต์แอป เช่น <div id="root"></div> หรือ <div id="app"></div>) หรือปิดตัวเลือกนี้
บล็อก devServer ที่สร้างขึ้นใช้พอร์ต 3000 พร้อม hot reload หากต้องการพอร์ตอื่น ให้แก้ค่า port ในไฟล์ที่คัดลอกไป
ได้ แต่ละตัวเลือกจะเพิ่มกฎของตัวเอง (ts-loader สำหรับ .ts และ .tsx และ babel-loader สำหรับ .js) คุณจึงใช้ตัวใดตัวหนึ่งหรือทั้งสองตัวก็ได้ React ที่ไม่ใช้ TypeScript ต้องใช้ Babel เพื่อคอมไพล์ JSX เครื่องมือจึงเปิด Babel ไว้เสมอในกรณีนั้น
เครื่องมือที่เกี่ยวข้อง
เครื่องมือสร้าง CSS Loader
สร้างสปินเนอร์วงกลมด้วย CSS ล้วน กำหนดเส้นผ่านศูนย์กลาง ความหนาของขอบ สี และความเร็วรอบ ดูตัวอย่างสด แล้วคัดลอกโค้ด CSS พร้อมใช้ได้เลย ไม่ต้องใช้ SVG หรือ JavaScript
ตัวตรวจสอบ OpenAPI
วางเอกสาร OpenAPI หรือ Swagger แบบ JSON หรือ YAML แล้วตรวจโครงสร้างหลัก: ฟิลด์เวอร์ชัน ออบเจกต์ info และ paths พร้อมข้อผิดพลาดและคำเตือนที่ชัดเจน
เครื่องมือจัดรูปแบบ PHP
เพิ่มการขึ้นบรรทัดใหม่และการเยื้อง 2 หรือ 4 ช่องให้ส่วนโค้ด PHP พื้นฐาน โปรดตรวจผลลัพธ์ เพราะเครื่องมือนี้ไม่ใช่ตัวแยกวิเคราะห์ PHP และไม่ได้ใช้กฎ PSR-12
เครื่องสุ่มที่อยู่
สร้างระเบียนคล้ายที่อยู่ 1–20 รายการสำหรับแบบจำลองและการทดสอบ ด้วยรูปแบบประเทศแบบย่อ
เครื่องแปลงฐานตัวเลข
แปลงตัวเลขระหว่างฐานสอง ฐานแปด ฐานสิบ ฐานสิบหก และฐานกำหนดเองตั้งแต่ 2 ถึง 36 พร้อมการแยกค่าประจำหลัก
อ้างอิงตัวอักษร HTML
รายการที่สามารถค้นหาได้ขององค์ประกอบ HTML พร้อมรหัสชื่อและรหัสตัวเลข รวมถึงฟังก์ชันสำเนาด้วยคลิกเดียวสำหรับตัวอักษรพิเศษและสัญลักษณ์ต่างๆ
เครื่องมือนี้มีให้บริการในภาษาอื่น
- Gerador de Configuração Webpack [PT]
- Trình tạo cấu hình webpack [VI]
- Webpack設定ジェネレーター [JA]
- مولّد إعدادات Webpack [AR]
- Webpack-konfigurationsgenerator [SV]
- Webpack 설정 생성기 [KO]
- Generador de Configuración de Webpack [ES]
- Générateur de configuration Webpack [FR]
- Webpack-Konfigurationsgenerator [DE]
- Generator Konfigurasi Webpack [ID]
- Webpack-configuratiegenerator [NL]
- Generator konfiguracji webpack [PL]
- Webpack Config Generator [EN]
- Generatore di Configurazione Webpack [IT]
- Генератор конфигурации webpack [RU]
- Webpack Yapılandırma Oluşturucu [TR]
- Webpack 配置生成器 [ZH]