حول حاسبة ترقيم الإصدارات SemVer — الدليل التفصيلي
تقوم حاسبة SemVer (SemVer Calculator) بتحليل وتقييم نصوص الإصدارات الدلالية (SemVer 2.0.0) وقيود نطاقات التبعيات. وتفصّل إصدارات Major وMinor وPatch ووسوم Prerelease والبيانات الوصفية لـ Build إلى مكونات منظمة.
اختبر نطاقات semver لملف package.json في npm (بما في ذلك `^1.2.3` و`~1.2.3` و`>=1.0.0 <2.0.0` و`1.x` والرمز العام `*` وتعبيرات الاتحاد `||`) للتحقق من التوافق، وفرز مصفوفات الإصدارات، ومعاينة ترقيات الإصدار التالية الموصى بها.
الميزات والقدرات الرئيسية
- تحليل كامل لمواصفات SemVer 2.0.0 وفق نسق (Major.Minor.Patch-prerelease+build)
- تقييم تعبيرات نطاقات npm: علامة الإقحام (^)، والتلدة (~)، والمقارنات، والمنطق الاتحادي
- مقارنة دقيقة للإصدارات وتشخيصات الفرز (gt وlt وeq وsatisfies)
- حساب تلقائي للإصدار التالي يعاين ترقيات إصدارات Major وMinor وPatch
طريقة الاستخدام
- 1
أدخل إصداراً أساسياً (مثل `2.4.1`) أو تعبير نطاق (مثل `^2.3.0`).
- 2
اكتب إصدار الإصدار المرشح للتحقق مما إذا كان يستوفي النطاق المحدد.
- 3
راجع نتيجة التطابق والعناصر المحللة والتوصيات الخاصة بالترقية التالية.
حالات الاستخدام الشائعة
- ← استكشاف انحراف التبعيات غير المتوقع وإصلاحه الناتج عن نطاقات علامة الإقحام (`^`) في package.json
- ← تحديد الإصدار التالي الصحيح قبل تنفيذ أمر npm publish أو git tag
- ← التحقق من قيود النطاقات في مساحات عمل المستودعات المتعددة (monorepo) وبرمجيات البناء المشتركة لـ CI/CD
أدوات ذات صلة
مولد وسوم SEO و Open Graph
توليد وسوم HTML الوصفية و Open Graph و بطاقات Twitter لتحسين ظهور المواقع في محركات البحث.
مولد ملف .gitignore
إنشاء ملفات .gitignore المخصصة للغات الأطر البرمجية المختلفة (Node و Python و Rust و Go).
مولد تراخيص المصادر المفتوحة
إنشاء نصوص التراخيص مفتوحة المصدر (MIT و Apache 2.0 و GPLv3 و BSD) مع حقوق النشر.
مولد ملف README لمشاريع Git
توليد قوالب ملفات README احترافية للمشاريع مفتوحة المصدر مع الشارات والإرشادات.
منشئ رسائل Conventional Commits
صياغة رسائل التعديل لـ Git وفقاً لمعيار Conventional Commits بدقة وتنظيم.
عارض مواصفات Swagger و OpenAPI
استعراض واختبار وتوثيق مواصفات واجهات البرمجة بصيغتي OpenAPI و Swagger محلياً.
الأسئلة الشائعة والخصوصية
ما هو الفرق الجوهري بين علامة الإقحام `^` (caret) والتلدة `~` (tilde)؟
يسمح النمط `~1.2.3` بإصدارات PATCH فقط (بما يطابق `>=1.2.3 <1.3.0`)، في حين يسمح `^1.2.3` بإصدارات MINOR وPATCH معاً (بما يطابق `>=1.2.3 <2.0.0`).
هل تؤثر البيانات الوصفية للبناء (مثل `+build123`) على أسبقية الإصدار؟
كلا. وفقاً للقسم 10 من مواصفات SemVer، فإن البيانات الوصفية للبناء هي بيانات إعلامية بحتة ويجب تجاهلها عند تحديد أسبقية الإصدار.