استخدام CLI لـ bun build

bun build <entry points>

التكوين العام

--productionboolean

تعيين NODE_ENV=production وتمكين التصغير

--bytecodeboolean

استخدام ذاكرة تخزين مؤقت للبايت كود عند التجميع

--targetstring default: browser

بيئة التنفيذ المقصودة للحزمة. واحدة من browser أو bun أو node

--conditionsstring

تمرير شروط حل مخصصة

--envstring default: disable

تضمين متغيرات البيئة في الحزمة كـ process.env.${name}. لتضمين المتغيرات التي تطابق بادئة، استخدم نمط مثل FOO_PUBLIC_*

الإخراج والتعامل مع الملفات

--outdirstring default: dist

دليل الإخراج (يُستخدم عند بناء نقاط دخول متعددة)

--outfilestring

كتابة الإخراج إلى ملف محدد

--sourcemapstring default: none

إنشاء خرائط المصدر. واحدة من linked أو inline أو external أو none

--bannerstring

إضافة لافتة إلى الإخراج (مثل "use client" لمكونات React Server)

--footerstring

إضافة تذييل إلى الإخراج (مثل // built with bun!)

--formatstring default: esm

تنسيق الوحدة للحزمة الناتجة. واحدة من esm أو cjs أو iife

تسمية الملفات

--entry-namingstring default: [dir]/[name].[ext]

تخصيص أسماء ملفات نقاط الدخول

--chunk-namingstring default: [name]-[hash].[ext]

تخصيص أسماء ملفات الأجزاء

--asset-namingstring default: [name]-[hash].[ext]

تخصيص أسماء ملفات الأصول

خيارات التجميع

--rootstring

الدليل الجذر المستخدم عند تجميع نقاط دخول متعددة

--splittingboolean

تمكين تقسيم الكود للوحدات المشتركة

--public-pathstring

البادئة التي ستُضاف إلى مسارات الاستيراد في الكود المجمع

--externalstring

استبعاد الوحدات من الحزمة (يدعم الأنماط). الاختصار: -e

--packagesstring default: bundle

كيفية معالجة التبعيات: external أو bundle

--no-bundleboolean

التحويل فقط - عدم التجميع

--css-chunkingboolean

تجميع ملفات CSS معًا لتقليل التكرار (فقط عند استيراد CSS من نقاط دخول متعددة)

التصغير والتحسين

--emit-dce-annotationsboolean default: true

إعادة إصدار تعليقات Dead Code Elimination. يتم تعطيله عند استخدام --minify-whitespace

--minifyboolean

تمكين جميع خيارات التصغير

--minify-syntaxboolean

تصغير الصيغة وتضمين الثوابت

--minify-whitespaceboolean

تصغير المسافات البيضاء

--minify-identifiersboolean

تصغير معرفات المتغيرات والدوال

--keep-namesboolean

الحفاظ على أسماء الدوال والفئات الأصلية عند التصغير

ميزات التطوير

--watchboolean

إعادة البناء تلقائيًا عند تغيير الملفات

--no-clear-screenboolean

عدم مسح الطرفية عند إعادة البناء مع --watch

--react-fast-refreshboolean

تمكين تحويل React Fast Refresh (لاختبار التطوير)

الملفات القابلة للتنفيذ المستقلة

--compileboolean

إنشاء ملف تنفيذي Bun مستقل يحتوي على الحزمة. يعني --production

--compile-exec-argvstring

إضافة وسائط إلى execArgv للملف التنفيذي المستقل

تفاصيل الملفات القابلة للتنفيذ في Windows

--windows-hide-consoleboolean

منع فتح نافذة وحدة التحكم عند تشغيل ملف تنفيذي مجمع في Windows

--windows-iconstring

تعيين أيقونة للملف التنفيذي في Windows

--windows-titlestring

تعيين اسم منتج الملف التنفيذي في Windows

--windows-publisherstring

تعيين اسم شركة الملف التنفيذي في Windows

--windows-versionstring

تعيين إصدار الملف التنفيذي في Windows (مثل 1.2.3.4)

--windows-descriptionstring

تعيين وصف الملف التنفيذي في Windows

--windows-copyrightstring

تعيين إشعار حقوق النشر للملف التنفيذي في Windows

الميزات التجريبية وبناء التطبيقات

--appboolean

(تجريبي) بناء تطبيق ويب للإنتاج باستخدام Bun Bake

--server-componentsboolean

(تجريبي) تمكين مكونات React Server

--debug-dump-server-filesboolean

عند تعيين --app، تفريغ جميع ملفات الخادم إلى القرص حتى للتجميعات الثابتة

--debug-no-minifyboolean

عند تعيين --app، تعطيل جميع التصغيرات