تثبيت Git وإعداده لأول مرة

قبل أن تحفظ أول نقطة في تاريخ مشروعك، يحتاج Git أن يعرف من أنت. فكل نقطة حفظ تسجل اسم صاحبها وبريده، تماماً كما يوقّع الموظف على كل مستند يعدّله. في هذا الدرس ستثبّت Git على جهازك، وتضبط إعداداته الأساسية مرة واحدة فقط، ثم تنساها.

التثبيت حسب نظام التشغيل

ويندوز:

1. ادخل الموقع الرسمي git-scm.com واضغط Download.
2. شغّل ملف التثبيت. الإعدادات الافتراضية مناسبة للمبتدئين، فاضغط Next حتى النهاية.
3. ستحصل على برنامج Git Bash: طرفية تفهم أوامر Linux، وستستخدمها كثيراً.

ماك: افتح الطرفية واكتب git --version. إذا لم يكن Git مثبتاً، سيعرض عليك النظام تثبيت أدوات المطور (Command Line Tools) تلقائياً، فوافق.

لينكس (Ubuntu ومشابهاتها):

sudo apt install git

وفي كل الأنظمة، تأكد من نجاح التثبيت:

git --version

الناتج

git version 2.56.0

(رقم الإصدار عندك قد يختلف، والمهم أن الأمر يعمل.)

تعريف نفسك لـ Git

هذا هو أهم إعداد، ويُكتب مرة واحدة فقط على كل جهاز:

git config --global user.name "Sara Ahmed"
git config --global user.email "sara@example.com"

• git config: أمر تغيير الإعدادات.
• --global: الإعداد يسري على كل مشاريعك في هذا الجهاز.
• user.name و user.email: اسمك وبريدك اللذان سيظهران في كل نقطة حفظ.

أي بريد أستخدم؟

إذا كنت ستستخدم GitHub، استخدم نفس البريد المسجل في حسابك هناك، حتى تُنسب إليك مساهماتك وتظهر في ملفك الشخصي. وإذا أردت إخفاء بريدك الحقيقي، يوفر GitHub بريداً خاصاً من نوع noreply تجده في إعدادات الخصوصية.

اسم الفرع الافتراضي

عند إنشاء أي مستودع جديد، ينشئ Git فرعاً أساسياً. الاسم الشائع حالياً هو main، وقد يكون master في الإعداد القديم. لتوحيد الاسم:

git config --global init.defaultBranch main

ستتعرف على الفروع بالتفصيل في الدرس الرابع.

اختيار المحرر

في بعض العمليات يفتح Git محرراً لتكتب رسالة. افتراضياً قد يفتح محرراً داخل الطرفية اسمه Vim، وهو محيّر جداً للمبتدئين! إذا كنت تستخدم VS Code:

git config --global core.editor "code --wait"

الآن سيفتح Git ملفاً في VS Code، وينتظر حتى تحفظه وتغلقه.

إذا علقت في Vim

إذا فتح Git محرر Vim ولم تعرف كيف تخرج، اضغط Esc، ثم اكتب :wq واضغط Enter للحفظ والخروج، أو :q! للخروج دون حفظ. هذه مشكلة يمر بها تقريباً كل مبرمج مرة واحدة على الأقل!

عرض إعداداتك

git config --global --list

الناتج

user.name=Sara Ahmed
user.email=sara@example.com
init.defaultbranch=main

ولقراءة إعداد واحد: git config user.name.

أين تُحفظ الإعدادات؟

إعدادات --global تُحفظ في ملف نصي عادي اسمه .gitconfig في مجلدك الشخصي:

• في ويندوز: C:\Users\اسمك\.gitconfig
• في ماك ولينكس: ~/.gitconfig

يمكنك فتحه بأي محرر نصوص. وهناك أيضاً إعدادات خاصة بمستودع واحد: إذا نفذت git config user.email "... داخل مستودع بدون --global، يسري الإعداد على هذا المستودع فقط. مفيد مثلاً لاستخدام بريد العمل في مشاريع العمل، وبريدك الشخصي في مشاريعك الخاصة.

تخيّل الإعدادات العامة مثل توقيعك الافتراضي على كل رسائلك، والإعداد الخاص بمستودع مثل توقيع خاص لرسائل جهة معينة.

الحصول على المساعدة

كل أمر في Git له صفحة مساعدة:

git help commit
git commit -h

الأول يفتح صفحة الشرح الكاملة، والثاني يعرض ملخصاً سريعاً للخيارات في الطرفية.

جرّب بنفسك

1. ثبّت Git على جهازك، وتأكد بـ git --version.
2. اضبط اسمك وبريدك بـ git config --global.
3. اضبط اسم الفرع الافتراضي إلى main.
4. إذا كنت تستخدم VS Code، اضبطه محرراً لـ Git.
5. اعرض إعداداتك بـ git config --global --list، ثم افتح ملف .gitconfig وقارن.

أخطاء شائعة

• نسيان ضبط الاسم والبريد: عند أول commit سيظهر خطأ Please tell me who you are مع شرح الأوامر المطلوبة.
• خطأ إملائي في البريد: لن تُربط مساهماتك بحسابك في GitHub. راجعه بـ git config user.email.
• نسيان علامات التنصيص حول الاسم: git config --global user.name Sara Ahmed تسجل Sara فقط! ضع الاسم بين علامتي تنصيص.

اختبر نفسك

سؤال

ما معنى الخيار --global في git config --global user.name؟

يرفع الإعداد على GitHubيجعل الإعداد يسري على كل مستودعاتك في هذا الجهازيخفي اسمك

سؤال

لماذا يحتاج Git اسمك وبريدك؟

لتسجيل صاحب كل نقطة حفظ في تاريخ المشروعلإرسال إعلاناتلتفعيل البرنامج

الخلاصة

• ثبّت Git من git-scm.com على ويندوز، ومن أدوات المطور على ماك، وبـ apt على لينكس.
• عرّف نفسك مرة واحدة: git config --global user.name و user.email.
• init.defaultBranch main لتوحيد اسم الفرع الأساسي.
• core.editor لاختيار محرر مريح مثل VS Code.
• الإعدادات العامة في .gitconfig، والإعداد بدون --global يخص المستودع الحالي فقط.