السلام عليكم ورحمة الله وبركاته
نبدأ بالصلاة على النبي محمد ﷺ

في هذا الدليل ستتعلم كيف تربط مشروعك بـ GitHub مباشرة من داخل VS Code، بدون الحاجة لحفظ أوامر كثيرة — كل شيء من واجهة بسيطة.

المتطلبات قبل البدء

تأكد من توفر الأدوات التالية:

١

تثبيت Git

🐧 Linux
sudo apt install git
🪟 Windows

قم بتحميله من الموقع الرسمي: git-scm.com ثم ثبّته بالإعدادات الافتراضية.

بعد التثبيت، تحقق أن كل شيء يعمل:

git --version
💡 إذا رجعت لك نسخة مثل git version 2.x.x فالتثبيت نجح.
٢

تثبيت إضافة GitHub في VS Code

  1. افتح VS Code.
  2. افتح نافذة الإضافات بالضغط على Ctrl + Shift + X.
  3. ابحث عن: GitHub Pull Requests and Issues
  4. اضغط Install.
ℹ️ هذه الإضافة تتيح لك تسجيل الدخول وإدارة مستودعاتك مباشرة من VS Code.
٣

تسجيل الدخول إلى GitHub

  1. بعد تثبيت الإضافة، سيظهر إشعار في الزاوية — اضغط Sign in.
  2. سيفتح المتصفح تلقائياً على صفحة تسجيل الدخول.
  3. سجّل دخولك إلى حساب GitHub.
  4. اضغط Authorize Visual Studio Code.
  5. عد إلى VS Code — ستجد حسابك متصلاً.
٤

إعداد اسمك وإيميلك في Git

هذه الخطوة مهمة — Git يستخدم هذه المعلومات لتعريف هوية كل commit تقوم بها. افتح Terminal داخل VS Code بالضغط على Ctrl + ` ثم اكتب:

git config --global user.name "اسم المستخدم"
git config --global user.email "الايميل"

مثال:

git config --global user.name "b2-3c"
git config --global user.email "ahmed@gmail.com"
⚠️ استخدم نفس الإيميل المسجّل في حساب GitHub حتى تظهر مساهماتك بشكل صحيح في ملفك الشخصي.
٥

ربط مشروعك بـ GitHub

  1. افتح مجلد مشروعك في VS Code عبر File → Open Folder.
  2. اضغط على أيقونة Source Control في الشريط الجانبي (أو Ctrl + Shift + G).
  3. اضغط Initialize Repository — سيُنشئ Git محلياً داخل مجلدك.
  4. في خانة الرسالة اكتب وصفاً للتغييرات، مثل: first commit
  5. اضغط Commit.
  6. اضغط Publish to GitHub.
  7. اختر Public (مرئي للجميع) أو Private (خاص).
🚀 VS Code سيُنشئ المستودع في GitHub ويرفع جميع ملفاتك تلقائياً في خطوة واحدة.
٦

رفع التعديلات لاحقاً

كلما أجريت تعديلات على مشروعك وأردت رفعها إلى GitHub:

  1. افتح Source Control.
  2. اكتب رسالة تصف التعديل.
  3. اضغط Commit.
  4. اضغط Push.

سيتم تحديث المستودع في GitHub فوراً.

💡 اجعل رسائل الـ commit واضحة ومعبّرة، مثل: fix navbar bug أو add about page. هذا يساعدك لاحقاً على فهم تاريخ مشروعك.