السلام عليكم ورحمة الله وبركاته
نبدأ بالصلاة على النبي محمد ﷺ
في هذا الدليل ستتعلم كيف تربط مشروعك بـ GitHub مباشرة من داخل VS Code، بدون الحاجة لحفظ أوامر كثيرة — كل شيء من واجهة بسيطة.
📋 فهرس المقالة
✓
المتطلبات قبل البدء
تأكد من توفر الأدوات التالية:
- Visual Studio Code — محرر الكود
- Git — أداة إدارة النسخ (سنثبّتها في الخطوة التالية)
- حساب على GitHub
١
تثبيت Git
🐧 Linux
sudo apt install git
🪟 Windows
قم بتحميله من الموقع الرسمي: git-scm.com ثم ثبّته بالإعدادات الافتراضية.
بعد التثبيت، تحقق أن كل شيء يعمل:
git --version
إذا رجعت لك نسخة مثل
git version 2.x.x فالتثبيت نجح.
٢
تثبيت إضافة GitHub في VS Code
- افتح VS Code.
- افتح نافذة الإضافات بالضغط على
Ctrl + Shift + X. - ابحث عن: GitHub Pull Requests and Issues
- اضغط Install.
هذه الإضافة تتيح لك تسجيل الدخول وإدارة مستودعاتك مباشرة من VS Code.
٣
تسجيل الدخول إلى GitHub
- بعد تثبيت الإضافة، سيظهر إشعار في الزاوية — اضغط Sign in.
- سيفتح المتصفح تلقائياً على صفحة تسجيل الدخول.
- سجّل دخولك إلى حساب GitHub.
- اضغط Authorize Visual Studio Code.
- عد إلى 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
- افتح مجلد مشروعك في VS Code عبر
File → Open Folder. - اضغط على أيقونة Source Control في الشريط الجانبي (أو
Ctrl + Shift + G). - اضغط Initialize Repository — سيُنشئ Git محلياً داخل مجلدك.
- في خانة الرسالة اكتب وصفاً للتغييرات، مثل:
first commit - اضغط Commit.
- اضغط Publish to GitHub.
- اختر Public (مرئي للجميع) أو Private (خاص).
VS Code سيُنشئ المستودع في GitHub ويرفع جميع ملفاتك تلقائياً في خطوة واحدة.
٦
رفع التعديلات لاحقاً
كلما أجريت تعديلات على مشروعك وأردت رفعها إلى GitHub:
- افتح Source Control.
- اكتب رسالة تصف التعديل.
- اضغط Commit.
- اضغط Push.
سيتم تحديث المستودع في GitHub فوراً.
اجعل رسائل الـ commit واضحة ومعبّرة، مثل:
fix navbar bug أو add about page.
هذا يساعدك لاحقاً على فهم تاريخ مشروعك.