مولّد إعدادات Webpack
يفرّغ webpack هذا المجلد في كل عملية بناء.
اترك الاسم المستعار فارغًا إن لم تكن بحاجة إليه. مع @ و src يمكنك كتابة @/components/Button.
كتابة webpack.config.js من الذاكرة تعني أن تتذكر البنية الدقيقة لـ output، والتعبير النمطي في test لكل مُحمِّل (loader)، والحزم التي يجب تثبيتها. يحوّل هذا المولّد كل ذلك إلى نموذج قصير: اختر JavaScript الخالصة أو React أو Vue 3، وحدّد ملف نقطة الدخول ومجلد المخرجات والوضع، ثم فعّل ما تحتاج إليه، من TypeScript وBabel إلى Sass والصور والخطوط وHtmlWebpackPlugin وخادم التطوير. يكتب المولّد إعدادات 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` وخادم التطوير وخرائط المصدر وفصل شيفرة المكتبات واسمًا مستعارًا للاستيراد.
-
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. |
| مجلد المخرجات | output.path محسوبًا بـ path.resolve(__dirname, 'dist')، إضافة إلى output.clean: true. |
| الوضع | mode: 'production' أو mode: 'development'. في الإنتاج تحمل الملفات الاسم [name].[contenthash].js عندما يكتب HtmlWebpackPlugin الصفحة، وفي التطوير [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 في التطوير أو MiniCssExtractPlugin في الإنتاج، يليهما css-loader؛ ويضيف Sass كلًّا من sass-loader والحزمة sass. |
| الصور والخطوط | قاعدتان من وحدات الأصول (asset modules) مع type: 'asset/resource'، وهي البديل في webpack 5 عن file-loader وurl-loader. |
| صفحة HTML | HtmlWebpackPlugin مع قالب index.html بجوار ملف نقطة الدخول. |
| خادم التطوير | كتلة devServer على المنفذ 3000 مع إعادة التحميل الفوري. ومع React أو Vue تُضاف historyApiFallback وpublicPath: '/' حتى تُحمَّل المسارات من جهة العميل. |
| خرائط المصدر | devtool: 'source-map' في الإنتاج و'eval-source-map' في التطوير. |
| فصل شيفرة المكتبات | optimization.splitChunks مع chunks: 'all'. |
| اسم مستعار للاستيراد | مُدخل في resolve.alias مثل '@': path.resolve(__dirname, 'src')، ويُكرَّر في paths داخل tsconfig.json مع TypeScript. |
ما تقرره الأداة نيابةً عنك
- مجلد مخرجات آمن. يفرّغ
output.cleanمجلد المخرجات في كل عملية بناء، لذا ترفض الأداةsrcوpublicوnode_modulesوالمجلد الجذر للمشروع وأي مجلد يحتوي على ملف نقطة الدخول. - طريقة واحدة لتحميل CSS. لا يُجمع أبدًا بين
style-loaderوMiniCssExtractPlugin، كما تحذّر وثائق الإضافة. - التجزئة (hash) فقط مع صفحة مولَّدة. لا يمكن لملف
index.htmlمكتوب يدويًا أن يشير إلى اسم ملف يحمل تجزئة، لذا تحمل الملفات من دونHtmlWebpackPluginالاسم[name].js، ويعرض خادم التطوير صفحتك من./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] ووحدات الأصول و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 مفعّلًا في هذه الحالة.
أدوات ذات صلة
عدّاد FPS
قِس معدل الإطارات FPS في المتصفح عبر requestAnimationFrame: تنعيم، وأدنى وأقصى معدل إطارات، وحد تنبيه، ورسم بياني اختياري. يعمل محليًا بلا رفع ملفات وبلا API.
مرجع جدول ASCII
جدول ASCII كامل من 0 إلى 127 مع التمثيل العشري والست عشري والثماني والثنائي والمرجع الرقمي في HTML لكل محرف، بما في ذلك أكواد التحكم مثل NUL وLF وDEL.
مدقّق OpenAPI
الصق مستند OpenAPI أو Swagger بصيغة JSON أو YAML وافحص بنيته الأساسية: حقل الإصدار وكائن info والمسارات، مع أخطاء وتحذيرات واضحة.
مولّد مؤشرات التحميل بلغة CSS
أنشئ دوّارًا دائريًا بـ CSS خالص: اضبط القطر وسماكة الحدود واللون وسرعة الدوران، وشاهد المعاينة المباشرة، وانسخ كود CSS جاهزًا للاستخدام. بلا SVG وبلا JavaScript.
مولد ظلال الألوان
توليد ظلال أغمق من لون أساسي بصيغة HEX عبر 3 إلى 20 خطوة متساوية، مفيدة للوحات نظام التصميم وحالات التمرير/الضغط.
منسّق PHP
أضف فواصل أسطر ومسافات بادئة من مسافتين أو 4 مسافات إلى مقطع PHP بسيط. راجع النتيجة: فهذه الأداة ليست محلّل PHP ولا تطبّق PSR-12.
الأداة متاحة بلغات أخرى
- Generador de Configuración de Webpack [ES]
- Webpack-konfigurationsgenerator [SV]
- Générateur de configuration Webpack [FR]
- Webpack-configuratiegenerator [NL]
- Webpack設定ジェネレーター [JA]
- Webpack 설정 생성기 [KO]
- ตัวสร้างการตั้งค่า Webpack [TH]
- Trình tạo cấu hình webpack [VI]
- Generator Konfigurasi Webpack [ID]
- Webpack-Konfigurationsgenerator [DE]
- Generator konfiguracji webpack [PL]
- Gerador de Configuração Webpack [PT]
- Webpack Config Generator [EN]
- Generatore di Configurazione Webpack [IT]
- Генератор конфигурации webpack [RU]
- Webpack Yapılandırma Oluşturucu [TR]
- Webpack 配置生成器 [ZH]