كيف تثبت Git — دليل إعداد البيئة 2026

**Git** هو **نظام إدارة الإصدارات** الأكثر استخداماً في العالم. هو ما يسمح للمطورين **بتتبع التغييرات** والعمل **معاً** على نفس المشروع. في هذا الدليل العملي، سنأخذك خطوة بخطوة لتثبيت Git وإعداد بيئة العمل، مع حل المشاكل الشائعة. ## ما هو Git؟ **Git** هو **نظام تحكم بالإصدارات (Version Control System)** موزّع. **تشبيه بسيط:** تخيل أنك تكتب مقالاً: - **بدون Git:** كل مرة تعدّل، تحفظ نسخة جديدة (`مقال_v1.doc`, `مقال_v2.doc`, ...). - **مع Git:** Git يتتبع كل التغييرات تلقائياً، ويمكنك الرجوع لأي نسخة سابقة. **Git يساعدك على:** - **تتبع التغييرات:** من عدّل ماذا ومتى. - **الرجوع:** استرجاع أي نسخة سابقة. - **العمل الجماعي:** عدة مطورين على نفس المشروع. - **التجريب:** تجربة ميزات جديدة بأمان. ## لماذا Git؟ قبل أن نبدأ، دعنا نتفق على الأسباب: - **الأكثر استخداماً:** 90%+ من المشاريع. - **مجاني ومفتوح المصدر.** - **سريع:** يعمل محلياً. - **آمن:** لا تفقد عملك. - **ضروري:** في كل وظيفة برمجة. ## Git vs GitHub **⚠️ مهم:** Git و GitHub **ليسا نفس الشيء**. <table> <thead> <tr> <th>المعيار</th> <th>Git</th> <th>GitHub</th> </tr> </thead> <tbody> <tr> <td><strong>ما هو؟</strong></td> <td>نظام إدارة إصدارات</td> <td>منصة استضافة</td> </tr> <tr> <td><strong>المكان</strong></td> <td>على جهازك</td> <td>على الإنترنت</td> </tr> <tr> <td><strong>الشركة</strong></td> <td>مفتوح المصدر</td> <td>Microsoft</td> </tr> <tr> <td><strong>البدائل</strong></td> <td>Mercurial</td> <td>GitLab، Bitbucket</td> </tr> </tbody> </table> **باختصار:** Git هو **الأداة**، GitHub هو **المكان** لاستضافة المستودعات. ## ما ستحتاجه <table> <thead> <tr> <th>المتطلب</th> <th>التفاصيل</th> </tr> </thead> <tbody> <tr> <td><strong>جهاز كمبيوتر</strong></td> <td>ويندوز 10/11 أو ماك أو لينكس</td> </tr> <tr> <td><strong>VS Code</strong></td> <td>محرر الأكواد (مجاني)</td> </tr> <tr> <td><strong>اتصال إنترنت</strong></td> <td>لتحميل Git و GitHub</td> </tr> <tr> <td><strong>وقت</strong></td> <td>15-20 دقيقة</td> </tr> </tbody> </table> ## الجزء الأول: تثبيت Git ### على ويندوز: 1. اذهب إلى: **git-scm.com** 2. اضغط **Download for Windows**. 3. اختر **64-bit Git for Windows Setup**. 4. شغّل ملف التثبيت. 5. اتبع الخطوات: - **Next** → **Next** (الإعدادات الافتراضية جيدة). - **Default editor:** اختر **Visual Studio Code**. - **PATH environment:** اختر **Git from the command line and also from 3rd-party software**. - **HTTPS transport:** اختر **Use the OpenSSL library**. - **Line ending conversions:** اختر **Checkout Windows-style, commit Unix-style line endings**. - **Terminal emulator:** اختر **Use MinTTY**. 6. اضغط **Install**. 7. انتظر 1-2 دقيقة. 8. اضغط **Finish**. ### على ماك: **الطريقة 1: باستخدام Homebrew (موصى به):** ```bash brew install git ``` **إذا لم يكن Homebrew مثبتاً:** ```bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ``` **الطريقة 2: باستخدام Xcode Command Line Tools:** ```bash xcode-select --install ``` **الطريقة 3: من الموقع:** 1. اذهب إلى **git-scm.com**. 2. حمّل النسخة لـ macOS. 3. ثبّتها. ### على لينكس: **Ubuntu/Debian:** ```bash sudo apt update sudo apt install git ``` **Fedora:** ```bash sudo dnf install git ``` ## الجزء الثاني: التأكد من التثبيت افتح Terminal (أو Git Bash على ويندوز)، واكتب: ```bash git --version ``` **النتيجة المتوقعة:** ``` git version 2.43.0 ``` **🎉 مبروك! Git مثبت!** ## الجزء الثالث: إعداد Git **قبل استخدام Git، يجب تعريف نفسك:** ```bash git config --global user.name "اسمك" git config --global user.email "[email protected]" ``` **مثال:** ```bash git config --global user.name "Ahmed Mohammed" git config --global user.email "[email protected]" ``` **⚠️ مهم:** استخدم **نفس البريد** الذي ستستخدمه في GitHub. ### التحقق من الإعدادات: ```bash git config --list ``` **النتيجة:** ``` user.name=Ahmed Mohammed [email protected] ... ``` ### إعدادات إضافية مفيدة: **1. تعيين المحرر الافتراضي:** ```bash git config --global core.editor "code --wait" ``` **2. تعيين الفرع الافتراضي:** ```bash git config --global init.defaultBranch main ``` **3. حل مشكلة الأسطر (ويندوز):** ```bash git config --global core.autocrlf true ``` **على ماك/لينكس:** ```bash git config --global core.autocrlf input ``` **4. عرض الألوان:** ```bash git config --global color.ui auto ``` ## الجزء الرابع: إنشاء حساب GitHub ### 1. التسجيل 1. اذهب إلى: **github.com** 2. اضغط **Sign up**. 3. أدخل: - **Email** (بريدك). - **Password** (كلمة مرور قوية). - **Username** (اسم المستخدم — اختر بحكمة). 4. أكمل التحقق. 5. اختر الخطة **Free**. ### 2. إعداد SSH (موصى به) **الخطوة 1: توليد مفتاح SSH:** ```bash ssh-keygen -t ed25519 -C "[email protected]" ``` **اضغط Enter** على كل الأسئلة (استخدم القيم الافتراضية). **النتيجة:** سيتم إنشاء مفتاحين: - `~/.ssh/id_ed25519` (المفتاح الخاص). - `~/.ssh/id_ed25519.pub` (المفتاح العام). **الخطوة 2: نسخ المفتاح العام:** **ويندوز (Git Bash):** ```bash cat ~/.ssh/id_ed25519.pub | clip ``` **ماك:** ```bash pbcopy < ~/.ssh/id_ed25519.pub ``` **لينكس:** ```bash cat ~/.ssh/id_ed25519.pub ``` **الخطوة 3: إضافته لـ GitHub:** 1. اذهب إلى GitHub → **Settings**. 2. **SSH and GPG keys → New SSH key**. 3. **Title:** اسم المفتاح (مثلاً "Laptop"). 4. **Key:** الصق المفتاح العام. 5. اضغط **Add SSH key**. **الخطوة 4: اختبار الاتصال:** ```bash ssh -T [email protected] ``` **النتيجة:** ``` Hi username! You've successfully authenticated... ``` ## الجزء الخامس: إعداد VS Code ### 1. تثبيت VS Code إذا لم يكن مثبتاً: 1. اذهب إلى: **code.visualstudio.com** 2. حمّل النسخة المناسبة. 3. ثبّتها. ### 2. الإضافات المهمة: <table> <thead> <tr> <th>الإضافة</th> <th>الوظيفة</th> </tr> </thead> <tbody> <tr> <td><strong>GitLens</strong></td> <td>عرض تاريخ التغييرات</td> </tr> <tr> <td><strong>Git Graph</strong></td> <td>رسم بياني للفروع</td> </tr> <tr> <td><strong>Git History</strong></td> <td>عرض تاريخ الملفات</td> </tr> <tr> <td><strong>GitHub Pull Requests</strong></td> <td>إدارة PR من VS Code</td> </tr> </tbody> </table> ### 3. الوصول لـ Git في VS Code افتح **Source Control** (`Ctrl + Shift + G`). ## الجزء السادس: أول مستودع ### 1. إنشاء مجلد المشروع ```bash mkdir my-first-repo cd my-first-repo ``` ### 2. تهيئة Git ```bash git init ``` **النتيجة:** ``` Initialized empty Git repository in /path/to/my-first-repo/.git/ ``` **ما حدث:** Git أنشأ مجلداً مخفياً `.git` يحتوي على كل بيانات المستودع. ### 3. إنشاء ملف README ```bash echo "# مشروعي الأول" > README.md ``` **أو** أنشئ ملف `README.md` في VS Code واكتب: ```markdown # مشروعي الأول هذا أول مستودع Git لي! ## المحتوى - ملف README ``` ### 4. إضافة الملف لـ Git ```bash git add README.md ``` **أو** إضافة كل الملفات: ```bash git add . ``` ### 5. إنشاء Commit ```bash git commit -m "أول commit: إضافة README" ``` **النتيجة:** ``` [main (root-commit) abc1234] أول commit: إضافة README 1 file changed, 5 insertions(+) create mode 100644 README.md ``` **🎉 مبروك! أنشأت أول Commit!** ### 6. عرض الحالة ```bash git status ``` **النتيجة:** ``` On branch main nothing to commit, working tree clean ``` ## حل المشاكل الشائعة ### 🔴 المشكلة 1: `'git' is not recognized` **السبب:** Git غير مضاف إلى PATH. **الحل:** 1. أعد تثبيت Git. 2. في خيار PATH، اختر **Git from the command line**. 3. أعد تشغيل Terminal. ### 🔴 المشكلة 2: `Please tell me who you are` **السبب:** لم تُعدّ `user.name` و `user.email`. **الحل:** ```bash git config --global user.name "اسمك" git config --global user.email "[email protected]" ``` ### 🔴 المشكلة 3: `Permission denied (publickey)` **السبب:** SSH غير مُعدّ. **الحل:** راجع الخطوات في "إعداد SSH". ### 🔴 المشكلة 4: خطأ في الأسطر (ويندوز) **الحل:** ```bash git config --global core.autocrlf true ``` ### 🔴 المشكلة 5: `fatal: not a git repository` **السبب:** لست داخل مستودع Git. **الحل:** ```bash git init ``` **أو** انتقل لمجلد فيه `.git`. ## جدول الأوامر الأساسية <table> <thead> <tr> <th>الأمر</th> <th>الوظيفة</th> </tr> </thead> <tbody> <tr> <td><code>git --version</code></td> <td>عرض الإصدار</td> </tr> <tr> <td><code>git config --global user.name</code></td> <td>تعيين الاسم</td> </tr> <tr> <td><code>git config --global user.email</code></td> <td>تعيين البريد</td> </tr> <tr> <td><code>git config --list</code></td> <td>عرض الإعدادات</td> </tr> <tr> <td><code>git init</code></td> <td>تهيئة مستودع</td> </tr> <tr> <td><code>git add .</code></td> <td>إضافة كل الملفات</td> </tr> <tr> <td><code>git commit -m "message"</code></td> <td>إنشاء commit</td> </tr> <tr> <td><code>git status</code></td> <td>عرض الحالة</td> </tr> <tr> <td><code>git log</code></td> <td>عرض السجل</td> </tr> </tbody> </table> ## قائمة تحقق نهائية <table> <thead> <tr> <th>المهمة</th> <th>الحالة</th> </tr> </thead> <tbody> <tr> <td>تثبيت Git</td> <td>⬜</td> </tr> <tr> <td>تأكيد عمل <code>git --version</code></td> <td>⬜</td> </tr> <tr> <td>إعداد <code>user.name</code> و <code>user.email</code></td> <td>⬜</td> </tr> <tr> <td>إنشاء حساب GitHub</td> <td>⬜</td> </tr> <tr> <td>إعداد SSH</td> <td>⬜</td> </tr> <tr> <td>تثبيت إضافات VS Code</td> <td>⬜</td> </tr> <tr> <td>إنشاء أول مستودع</td> <td>⬜</td> </tr> <tr> <td>أول Commit</td> <td>⬜</td> </tr> </tbody> </table> ## ماذا بعد هذا المقال؟ الآن بعد أن أصبحت بيئة العمل جاهزة، حان وقت التعلم: 1. **أول مستودع Git** — تعمق في الأساسيات. 2. **الـ Commits** — كيف تكتب commits احترافية. 3. **الفروع (Branches)** — العمل على ميزات متعددة. ## الخلاصة تثبيت Git وإعداده عملية بسيطة. أهم النقاط: - ✅ **Git** هو نظام إدارة الإصدارات. - ✅ **GitHub** هو منصة استضافة. - ✅ **الإعداد** ضروري قبل الاستخدام. - ✅ **SSH** أأمن من HTTPS. - ✅ **VS Code** يدعم Git بشكل ممتاز. **تذكر:** Git هو **المهارة الأولى** التي يجب أن يتعلمها كل مطور.