git clone

نسخ مستودع موجود git clone

git clone ينسخ مستودعًا كاملًا (بكل تاريخه وفروعه) من رابط بعيد إلى جهازك، وينشئ الربط بالمصدر تلقائيًا.

git clone يأخذ رابط مستودع بعيد (من GitHub غالبًا) وينسخ كل شيء: الملفّات الحالية، كل commit حدث سابقًا، وكل الفروع والوسوم. يضبط تلقائيًا remote باسم origin يشير لهذا الرابط، فتقدر مباشرة تعمل push وpull دون إعداد إضافي.

هذا هو الأمر الذي تستخدمه دائمًا عند البدء بالعمل على مشروع موجود مسبقًا — سواء مشروع فريقك أو مشروع مفتوح المصدر أعجبك على GitHub.

الصياغة

git clone <رابط-المستودع> [اسم-مجلّد-اختياري]

📄 مثال

git clone https://github.com/user/project.git
cd project

# باسم مجلّد مختلف
git clone https://github.com/user/project.git my-copy

# فرع محدّد فقط
git clone -b develop https://github.com/user/project.git

أهم الخيارات

الخيار	الوظيفة
-b <branch>	يستنسخ فرعًا محدّدًا بدل الفرع الافتراضي
--depth 1	استنساخ ضحل — آخر commit فقط، بلا تاريخ كامل، أسرع للمستودعات الكبيرة
--recurse-submodules	يجلب أيضًا محتوى المستودعات الفرعية (submodules) إن وُجدت

💡 نصائح عملية

استخدم رابط HTTPS ما لم يكن لديك مفتاح SSH مُعدّ مسبقًا — أبسط للبداية
clone --depth 1 مفيد جدًا في بيئات CI حيث لا تحتاج التاريخ الكامل، فقط آخر نسخة

⚠️ أخطاء شائعة

استخدام git init داخل مجلّد فارغ ثم إضافة remote يدويًا بدل clone البسيط — خطوات أكثر بلا داعٍ
نسيان --recurse-submodules عند استنساخ مشروع يعتمد على مستودعات فرعية، فتبقى مجلّداتها فارغة

🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار GIT الكامل بالعربي.