مُولِّد package.json
مرشد
مُولِّد package.json
يُنتج ملفًا صالحًا package.json من نموذج مُهيكل بدل أن تُذكر كل حقل بدقة. قم بتحديد اسم الحزمة، النسخة، الترخيص، نظام الوحدة (ESM أو CommonJS)، محرك نود، البرامج، والاعتمادات، ثم يُنتج الأداة ملفًا نظيفًا مُرتّبًا يمكنك وضعه مباشرة في مشروعك.
بخلاف الأداة التي تعيد ترتيب ملف موجود، فإن هذا المُولّد يُنشئ الملف من الصفر ويُتجاهل الحقول الفارغة، لذا تُحصل على ملف مُختصر وقابل للنشر، وهو يلتزم بالمعايير التي يستخدمها npm. npm init.
كيفية استخدام
- أدخل اسم الحزمة، النسخة، و(اختياريًا) الوصف والمؤلف.
- اختر ترخيصًا واختر وحدات ES أو CommonJS لنظام الوحدة.
- حدد المُدخل (مثلاً
index.js) ونطاق engines.node مثل>=18. - أدخل البرامج التي تستخدمها (
dev,build,test,start) — اترك الحقول فارغة لتجاهلها. - أضف الاعتمادات والاعتمادات المُطوّرة كـ
name@range، واحد في كل سطر أو مفصولة بفاصلة. - اختر التباعد (مُسافتين، أربع مسافات، أو مُسافات مُتسلسلة) ثم نسخ أو تحميل المُولّد
package.json.
خصائص
- مُوجه بناءً على النموذج – لا حاجة لحفظ أسماء الحقول أو الترتيب بدقة؛ يتم تعبئة المفاتيح الشائعة لك.
- ESM أو CommonJS – تبديل نظام الوحدة، ويُحدد الأداة
"type": "module"وmoduleالمدخل بشكل مناسب. - برامج ذكية – يتم إزالة الحقول الفارغة بدلًا من تركها كمُستعارات.
""مُستعارات. - تحليل الاعتمادات – لصق قائمة من
package@^1.2.3وتصبح كائنًا مُنظّم.dependenciesمُتّصل. - مُساعدين للمخزن – ضع رابط جيت هاب وينتج المُولّد
repository,bugsو، وhomepageلأنت. - مُميّز الحزمة الخاصة – نقرة واحدة تُشير إلى الحزمة كخاصة لمنع النشر العفوي.
npm publish. - أدخل التباعد – أخرج التباعد كمُسافتين، أربع مسافات، أو مُسافات مُتسلسلة لتتماشى مع نمط المخزن الحالي.
- النسخ أو التنزيل – احصل على النتيجة كنص أو تحميل
package.jsonمباشرة.
التعليمات
-
ما الفرق بين الاعتمادات واعتمادات التطوير؟
dependenciesهي حزم تُستخدم في وقت التشغيل وستُثبت أيضًا من قبل المستخدمين لحزمةك.devDependenciesهي أدوات تحتاجها فقط أثناء التطوير أو بناء المشروع — مثل مُجمّعات، أدوات اختبار، مُدققين للأنواع — ولا تُثبت عند إضافة حزمةك إلى مشروع آخر. -
ما الذي يفعله تعيين type إلى module؟
جلسة
"type": "module"يُخبر نود.js بتحويل الملفات في الحزمة إلى وحدات ES، لذا فإن.jsتُستخدم بشكل طبيعي. بدون ذلك، يتعامل نود معimportوexportكوحدات CommonJS ويجب استخدام.js. تتيح وحدات ES استخدام الأعلىrequire/module.exportsوتحديد مسار الملف بشكل أكثر صرامة.awaitلماذا يستخدم package.json نسخة معنوية؟ -
النسخة المعنوية (الكبير.الصغير.الصورة) تُعطي المستخدمين عقدًا: يجب أن تكون ترقية PATCH آمنة، تضيف تحسينات متوافقة مع الاتجاه، والكبير يشير إلى تغييرات مُقفلة. تُستخدم مُؤشرات النطاق مثل
على هذا العقد لكي يُمكن لـ npm أن يُثبت تحديثات متوافقة دون أن يُؤثر على بنية المشروع.
^و~ما هو مقصود بحقل engines؟ -
يُعلن عن إصدارات نود (أو أي بيئة تشغيل) التي تدعمها الحزمة. تظهر أداة npm وعديد الأدوات تحذيرًا عند استخدام إصدار غير مدعوم، وتعمل بعض المنصات على رفض التثبيت تمامًا. تُحدد النطاق المُحدد
ال
enginesلمنع أخطاء خفيفة ناتجة عن واجهات برمجة توجد في إصدارات نود أحدث.nodemy-package
تثبيت ملحقاتنا
أضف أدوات IO إلى متصفحك المفضل للوصول الفوري والبحث بشكل أسرع
恵 وصلت لوحة النتائج!
لوحة النتائج هي طريقة ممتعة لتتبع ألعابك، يتم تخزين جميع البيانات في متصفحك. المزيد من الميزات قريبا!
