UUID v4 نموذجي
550e8400-e29b-41d4-a716-446655440000
خمس مجموعات ست عشرية تفصل بينها شَرطات. الرقم 4 في الموضع 13 يدلّ على أن هذا UUID من الإصدار الرابع (العشوائي).
أنشئ معرفات UUID v1/v4 بالجملة وجاهزة للنسخ.
Last updated
ad7c87f8-dfcd-40d2-8b8f-a1601d56526bfb3ea850-348e-4601-90f7-8f3b6eeda24a4083e096-99cc-4813-9839-e27c855755dda31e0545-3bdc-47cd-884b-e2c3c8b9797e5f3ff6b3-fad9-41d6-91f0-70d3f4d071c76775259f-6b31-483f-a91b-b84c44ab7b5b0703fda9-8a16-44e0-9ad8-dc9f42728ea4ff627379-fd22-430e-9ca0-4be4a9735713dac99e1b-ab79-4a8a-8318-6ac1d213f60b9099ee48-da2b-4ef2-88f5-c652d186f44cمولّد UUID ينشئ معرّفات فريدة عالميًا (Universally Unique Identifiers) — قيمًا بحجم 128 بت مضمونة إحصائيًا ألّا تتصادم مع أي UUID آخر يُولَّد في أي مكان آخر. يستخدمها المطوّرون كمفاتيح أساسية لصفوف قواعد البيانات، ومعرّفات لموارد الـ API، وأسماء لبيانات الاختبار، ومعرّفات للرسائل في طوابير المعالجة، وكمعرّفات في الأنظمة الموزّعة.
تتميّز معرّفات UUID بأن كل جهاز يستطيع توليد واحد منها بشكل مستقل واثقًا أن لا أحد غيره سينتج القيمة ذاتها. لا يوجد عدّاد مركزي، ولا تسلسل يحتاج إلى تنسيق، ولا حتى رحلة ذهاب وعودة إلى الخادم. هذا ما يجعلها عملية في كل نظام يحتاج إلى توليد معرّفات دون استئذان أحد.
*GUID* (المعرّف الفريد عالميًا) هو الاسم الذي تستخدمه Microsoft للإشارة إلى المعرّف نفسه بحجم 128 بت. من الناحية العملية بالنسبة للمطوّر، GUID و UUID يعنيان الشيء ذاته — لكلٍّ من البيئتين تسميتها المفضّلة فقط.
اختر v4 للمعرّفات العشوائية، أو v7 لمعرّفات مرتّبة زمنيًا تعمل جيدًا مع الفهارس، أو v1 للأنظمة القديمة التي تحتاج إلى طابع زمني + معرّف عقدة.
ولّد UUID واحدًا للحصول على معرّف سريع، أو ولّد حتى 1000 دفعة واحدة عند تعبئة قاعدة بيانات أو محاكاة استجابات API.
فعّل أو عطّل الأحرف الكبيرة والشرطات والأقواس المعقوفة ({...}) لتطابق الصيغة التي تتوقّعها قاعدة بياناتك أو شيفرتك أو منصّتك.
انسخ UUID واحدًا أو القائمة كاملة. كل شيء يُولَّد محليًا داخل متصفّحك.
الإصدارات الخمسة الأكثر استخدامًا، ومتى تختار كلًّا منها.
| الإصدار | مصدر التفرّد | متى تستخدمه |
|---|---|---|
| v1 | طابع زمني + عنوان MAC | الأنظمة القديمة؛ قد يُسرّب عنوان MAC للجهاز |
| v3 | تجزئة MD5 لاسم + فضاء أسماء | معرّفات قابلة للتنبؤ مشتقّة من نص |
| v4 | عشوائية تشفيرية | الخيار الافتراضي لمعظم التطبيقات — استخدمه عند التردّد |
| v5 | تجزئة SHA-1 لاسم + فضاء أسماء | مثل v3 لكن بدالة تجزئة أقوى |
| v7 | طابع زمني Unix (ms) + عشوائية | مفاتيح أساسية في قواعد البيانات — قابلة للترتيب زمنيًا |
550e8400-e29b-41d4-a716-446655440000
خمس مجموعات ست عشرية تفصل بينها شَرطات. الرقم 4 في الموضع 13 يدلّ على أن هذا UUID من الإصدار الرابع (العشوائي).
{ "id": "550e8400-e29b-41d4-a716-446655440000", "name": "Lesson 1", "createdAt": "2026-04-25T10:00:00Z"}تعرض الـ APIs عادةً معرّفات UUID كسلاسل نصية ضمن JSON. كثير من قواعد البيانات يدعم أيضًا نوع عمود UUID أصليًّا يخزّن 16 بايت بدلًا من 36 رمزًا نصيًّا.
550e8400-e29b-41d4-a716-446655440000
550E8400-E29B-41D4-A716-446655440000
{550E8400-E29B-41D4-A716-446655440000}
550e8400e29b41d4a716446655440000
القيمة نفسها بحجم 128 بت، لكن بأربع صيغ ظاهرية مختلفة. اختر واحدة والتزم بها داخل المشروع — خلط الصيغ يسبّب أخطاء مقارنة محيّرة.
crypto.randomUUID() في المتصفّح و Node.js، و uuid.uuid4() في Python، و UUID.randomUUID() في Java.