مولّد إعدادات Webpack

webpack.config.js

يفرّغ webpack هذا المجلد في كل عملية بناء.

يحتاج React من دون TypeScript إلى Babel لتحويل JSX.

يتطلب تفعيل خيار صفحة HTML، الذي يضيف الملفات المفصولة إلى الصفحة نيابةً عنك.

اترك الاسم المستعار فارغًا إن لم تكن بحاجة إليه. مع @ و 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. 1

    حدّد الدخول والمخرجات

    اكتب ملف نقطة الدخول ومجلد المخرجات (الافتراضي `dist`). يتغير ملف الدخول المقترح بحسب إطار العمل، مثل `./src/index.tsx` لمشروع React مع TypeScript.

  2. 2

    اختر الوضع وإطار العمل

    اختر `production` أو `development`، ثم JavaScript الخالصة أو React أو Vue 3. يحدد الوضع أسماء الملفات ونوع خرائط المصدر وطريقة تحميل CSS.

  3. 3

    فعّل المحمّلات والإضافات

    فعّل ما تحتاج إليه: TypeScript وBabel وCSS وSass والصور والخطوط و`HtmlWebpackPlugin` وخادم التطوير وخرائط المصدر وفصل شيفرة المكتبات واسمًا مستعارًا للاستيراد.

  4. 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.

الأداة متاحة بلغات أخرى