هل حذفت ملفًا بالخطأ أو كتبت على كودك دون إمكانية استرداده؟ بدون نظام التحكم بالإصدارات، يمكن أن تكون هذه الأخطاء كارثية. هنا تأتي git init
– إذ يحول مجلد مشروعك إلى مستودع Git، مضمنًا تتبع كل تغيير وإمكانية استرداده.
في هذا البرنامج التعليمي، سأريك كيفية إعداد Git، وأشاركك بنصائح شخصية من رحلتي، وأساعدك في إنشاء سير عمل قوي من البداية.
ما هو Git Init؟
أمر git init
يبدأ رحلتك في التحكم بالإصدارات. عند تشغيله، ينشئ Git مجلدًا مخفيًا بداخل دليل مشروعك يحتوي على بيانات التكوين، تاريخ الcommit، وجميع البيانات الوصفية اللازمة لتتبع تغييراتك.
مع تسجيل كل تعديل، يمكنك الفروع، الدمج، والتعاون بثقة – عالمًا بأن تاريخ مشروعك الكامل دائمًا على بعد أمر واحد فقط.
صورة بواسطة المؤلف
كيفية استخدام Git Init
قبل الانتقال إلى المواضيع المتقدمة، من الضروري فهم كيفية استخدام git init
عملياً.
استخدام أساسي لـ git init
اتبع هذه الخطوات لإنشاء مستودع Git جديد من البداية:
- افتح نافذة الطرفية الخاصة بك: قم بتشغيل واجهة سطر الأوامر المفضلة لديك.
- انتقل إلى دليل مشروعك:
cd /path/to/your/project
هذا يغير المجلد الحالي إلى المجلد الذي تريد تتبعه.
- قم بتهيئة المستودع:
git init
بعد تنفيذ هذا الأمر، يتم إنشاء مجلد .git
المخفي. يخزن هذا المجلد كل معلومات تتبع Git.
- تحقق من حالة المستودع:
git status
في هذه المرحلة، تم إعداد Git ولكنه لا يتتبع أي ملفات.
تهيئة مستودع باستخدام مشروع موجود سابقًا
للمشاريع التي لم تكن تحت التحكم بالإصدارات بعد، يمكنك تهيئة Git وبدء تتبع التغييرات على النحو التالي:
- انتقل إلى دليل المشروع الخاص بك:
cd /path/to/your/project
- حول المشروع إلى مستودع Git:
git init
كما هو مذكور سابقًا، تنشئ الأمر أعلاه مجلد .git
المخفي الذي يمكن التعقب به باستخدام Git.
- حدد ملفاتك: نظرًا لأن
git init
لا يتتبع الملفات تلقائيًا، يجب إضافتها باستخدام:
git add .
- قُم بتأكيد ملفاتك: حفظ اللقطة الأولية بتشغيل:
git commit -m "Initial commit"
يُحول هذا العملية المشروع الذي لا يُدار إلى مشروع يحتوي على تاريخ نسخة كامل، جاهز للتطوير الجديد والتعاون.
تكوين Git (إذا كان مطلوبًا)
إذا واجهت خطأ “هوية المؤلف غير معروفة”، فهذا يعني أن Git لا يعرف من أنت. لحل هذه المشكلة، قم بتكوين هويتك كمستخدم:
- قم بإعداد معلومات مستخدم Git:
git config --global user.email "[email protected]" git config --global user.name "Your Name"
باستخدام --global
، تُطبق هذه الإعدادات على جميع المستودعات على جهازك. بينما بدونها ستضبط الهوية فقط للمستودع الحالي.
- تحقق من تكوينك:
git config --global user.email git config --global user.name
- أعد المحاولة للتأكيد:
git commit -m "First Commit"
واجهت هذا الخطأ عندما بدأت استخدام Git – حلتها باعتماد هويتي.
نجحت عملية الإلتزام الأولية في Git في PowerShell.
الاتصال بمستودع بعيد
بمجرد تهيئ مستودع Git محليًا، من المحتمل أن ترغب في عمل نسخ احتياطية له أو التعاون مع الآخرين عن طريق ربطه بمستودع بعيد (مثل GitHub، GitLab، Bitbucket).
- أضف مستودعًا عن بُعد: لربط مستودعك المحلي بمستودع بُعيد، استخدم:
git remote add origin <repository-url>
استبدل <repository-url>
بعنوان URL لمستودعك البُعيد. origin
هو الاسم الافتراضي للمستودع البُعيد، ولكن يمكنك استخدام أي اسم آخر.
- يمكنك التحقق من الاتصال باستخدام:
git remote -v
- قم بدفع تغييراتك إلى المستودع البُعيد:
# ادفع الرف الأول وتتبع الفرع البُعيد git push -u origin $(git branch --show-current) # يعمل لـ 'main' أو 'master'
الأمر أعلاه يدفع الفرع الحالي ويعينه لتتبع الفرع البعيد.
إذا كنت تستخدم إصدارًا أقدم من Git لا يدعم $(git branch --show-current)
، استخدم:
git push -u origin main # أو 'master' تبعاً لفرعك الافتراضي
بينما تواصل العمل على مشروعك، ستحتاج إلى دمج التغييرات من فروع مختلفة عند التعاون مع فريق. تعرف على كيفية التعامل مع الدمج بفعالية من خلال هذا دليل دمج Git.
المصادقة والوصول
إذا كنت تريد دفع التغييرات إلى GitHub أو GitLab أو Bitbucket، قد تحتاج إلى مصادقة. وتبعًا لإعدادك، يمكنك:
- استخدم مفاتيح SSH بدلاً من مصادقة HTTPS (موصى بها للأمان):
git remote set-url origin [email protected]:your-username/your-repo.git
- استخدم رمز وصول شخصي (PAT) بدلاً من كلمة مرور عند استخدام HTTPS. بالنسبة لـ GitHub، قم بتعويض كلمة المرور برمز:
git push https://[email protected]/your-repo.git
كان الاتصال بمستودع بعيد المكان نقطة تحول بالنسبة لي – فقد أكد لي أن عملي المحلي محفوظ بأمان وجاهز للتعاون. بالإضافة إلى ذلك، أعطاني ثقة في التحكم بالإصدارات، علما بأن تاريخي محفوظ حتى لو فشل جهازي المحلي.
الخيارات المتقدمة مع Git Init
لأولئك الذين يرغبون في تخصيص إعدادات Git الخاصة بهم، توفر الخيارات المتقدمة مرونة إضافية.
تهيئة مستودع فارغ
إذا كنت تقوم بإعداد خادم Git حيث سيقوم المطورون بدفع تغييراتهم ولكن لن يقوموا بتحرير الملفات مباشرة، ستحتاج إلى مستودع فارغ. يتجاهل المستودع الفارغ دليل العمل ويحتوي فقط على بيانات التحكم في الإصدار. عادةً ما يُستخدم للمستودعات البعيدة:
git init --bare <repository-name>
غالبًا ما يُستخدم المستودعات الفارغة في سير العمل GitOps، حيث يتم إدارة البنية التحتية ونشر التطبيقات من خلال Git. إذا كنت مهتمًا بمعرفة كيفية أتمتة GitOps وتبسيط تسليم البرنامج، راجع دليل GitOps هذا.
البدء بالتهيئة باستخدام تكوين محدد
إذا كنت بحاجة إلى خطوط مخصصة لـ Git أو ملفات تكوين من البداية، قم بالبدء بقالب مخصص:
git init --template=<template-directory>
لقد استخدمت قالبًا مخصصًا مرة واحدة لتحميل الخطوط الأساسية تلقائيًا، مما سهل عملية نشر فريقنا.
أفضل الممارسات لاستخدام Git Init
البدء بقدم صحيحة مع Git يمكن أن يوفر لك الوقت والمتاعب فيما بعد.
تنظيم هيكل مشروعك
قبل تشغيل git init
، قم بتنظيم ملفاتك في هيكل مجلد منطقي – فصل الشفرة، وثائق، والموارد.
في مشروع ورثته، تم خلط ملفات من عدة مشاريع فرعية مما أدى إلى صراعات الدمج والارتباك. من خلال إعادة تنظيم كل شيء في مجلدات معرفة بوضوح، وإعادة تهيئة المستودع، وإعداد ملف .gitignore
السليم، تحسن سير العمل بشكل كبير.
إضافة ملف .gitignore
في وقت مبكر
فور تهيئة مستودعك، قم بإنشاء ملف .gitignore
لمنع تتبع الملفات غير الضرورية:
touch .gitignore
ثم، قم بتحريره لتضمين قواعد مثل:
# تجاهل مجلدات الاعتماد وملفات السجل node_modules/ *.log .DS_Store # ملف نظام macOS Thumbs.db # ملف نظام Windows
هذه الخطوة أنقذتني من تاريخ تعهد ضخم وصراعات محتملة في المستقبل.
للحصول على دليل مفصل حول تكوين ملف .gitignore
، تحقق من هذا دليل gitignore.
التزام بشكل متكرر
إن إجراء عمليات الالتزام الصغيرة والمتكررة برسائل واضحة يساعد في بناء تاريخ المشروع بتفصيل ويبسط عمليات التصحيح والتعاون.
حل مشاكل تهيئة Git الشائعة
حتى مع التخطيط الجيد، قد تحدث مشاكل. إليك بعض المشكلات الشائعة والعلاجات.
تهيئة بالخطأ في الدليل الخاطئ
المشكلة: لقد قمت بتشغيل git init
في المجلد الخاطئ والآن لديك مستودع Git غير مرغوب فيه.
الحل:
- قم بإزالة مستودع Git:
rm -rf .git
> تحذير: سيؤدي هذا إلى حذف جميع سجلات النسخ الاحتياطية لهذا المستودع. تأكد من أنك في المجلد الصحيح قبل تشغيل هذا الأمر!
ثم، انتقل إلى الدليل الصحيح وقم بتشغيل git init
مرة أخرى.
لقد ارتكبت هذا الخطأ عدة مرات، لذا تحقق مرتين من دليل العمل الخاص بك لتجنب ذلك.
التعامل مع الملفات غير المتتبعة
المشكلة: بعد تشغيل git init
، لا تتتبع Git الملفات الخاصة بك. تشغيل git status
يظهر:
No commits yet Untracked files: (use "git add <file>..." to include in what will be committed)
الحل:
- تحقق مما إذا كانت الملفات غير متتبعة حقًا:
git status
إذا ظهرت ملفاتك تحت Untracked files، فإن Git يراها ولكنه لا يتتبعها بعد.
- ثم، قم بمرحلة الملفات الضرورية باستخدام:
git add <file-name>
- قم بتنفيذ commit للملفات:
git commit -m "Initial commit"
الفحوصات الدورية للحالة تضمن عدم تجاهل أي شيء مهم.
إذا أظهرت git status
عدم وجود ملفات، تحقق مما إذا كان مشروعك يحتوي على ملف .gitignore
الذي قد يستبعد ملفات مهمة.
الاستنتاج
إتقان git init
هو الخطوة الأساسية الحاسمة نحو بناء نظام تحكم في الإصدارات موثوق يعزز التعاون وإدارة المشاريع بكفاءة. اتبع هذا الدليل — من تهيئة وتنظيم مستودعك إلى حل المشكلات الشائعة — لإعداد سير عمل سلس وفعال.
ابدأ بشيء بسيط — قم بتهيئة مشروع اختباري باستخدام git init
وقم بتجربة التجميع والتأكيد ودفع التغييرات. كلما أتقنت أساسيات Git في وقتٍ مبكر، كلما كان سير عملك أكثر كفاءة! وإذا كنت متحمسًا لتعزيز مهاراتك في Git بشكل أعمق، تحقق من هذه الدورات في DataCamp:
- Git المتوسط – قم بتعزيز مهاراتك مع تقنيات التفرع المتقدمة والدمج وحل الصراعات.
- أسس GitHub – تعلم كيفية دمج Git بسلاسة مع GitHub لمشاريع التعاون.
الترميز الممتع – وها هو لبناء مشاريع موثوقة ومبتكرة باستخدام Git!