الأسبوع 0: Git و GitHub
تمهيدي | التحكم بالإصدارات والعمل الجماعي
جامعة الأقصى
الأسبوع 0: Git & GitHub
التحكم بالإصدارات والعمل الجماعي - الأساس الذي يحتاجه كل مطوّر
أسبوع تمهيدي - نستخدمه طوال المساق
1. ما هو Git؟ نظام التحكم بالإصدارات (Version Control System)
المشكلة بدون Git
تخيّل أنك تعمل على مشروع:
- أجريت تعديلًا فتعطّل المشروع - كيف ترجع إلى النسخة القديمة؟
- أنت وزميلك تعملان على الملف نفسه - كيف تدمجان عملكما معًا؟
- تحتاج إلى الرجوع لنسخة من قبل أسبوع - أين هي؟
- تريد تجربة فكرة جديدة دون أن تُفسد الكود الأصلي
الحل: Git
Git هو نظام للتحكم بالإصدارات (Version Control System) يحفظ كل تغيير تجريه على المشروع، ويسمح لك بالرجوع إلى أي نقطة سابقة.
- Git = أداة على جهازك (محلية - Local) تتتبّع التغييرات
- GitHub = موقع على الإنترنت يخزّن مشاريعك (سحابي - Cloud) ويتيح العمل الجماعي
جهازك (محلي)
→
Git (يتتبّع التغييرات)
→
GitHub (السحابة)
كيف يعمل Git؟ - المناطق الثلاث
يحتوي Git على 3 مناطق رئيسية:
مجلد العمل (Working Directory)
الملفات التي تعمل عليها - التغييرات الحالية
منطقة التجهيز (Staging Area)
ملفات جاهزة للحفظ (git add)
المستودع (Repository)
تغييرات محفوظة بشكل دائم (git commit)
المستودع البعيد (Remote - GitHub)
النسخة الموجودة على الإنترنت (git push)
تعديل الملف
git add →
التجهيز (Staging)
git commit →
المستودع المحلي
git push →
GitHub
2. التثبيت والإعداد Installation & Setup
تثبيت Git
- Windows: حمّله من موقع git-scm.com واختر الإعدادات الافتراضية
- Mac: افتح الطرفية (Terminal) واكتب
git --version (غالبًا يكون مثبّتًا مسبقًا)
- بعد التثبيت، افتح Terminal أو Git Bash وتحقّق:
Terminalالتحقق من التثبيت
git --version
# git version 2.43.0
الإعداد الأولي (مرة واحدة فقط)
عليك أن تعرّف Git بنفسك - هذه المعلومات تظهر مع كل Commit (عملية حفظ):
Terminalإعداد Git
# تعيين اسمك
git config --global user.name "Your Name Here"
# تعيين بريدك الإلكتروني (نفس بريد حسابك على GitHub)
git config --global user.email "your@email.com"
# التحقق من الإعدادات
git config --list
إنشاء حساب على GitHub
اذهب إلى github.com واضغط على Sign up
أدخل بريدك الإلكتروني واسم المستخدم (اختر اسمًا احترافيًا) وكلمة المرور
فعّل حسابك عبر البريد الإلكتروني
أكمل ملفك الشخصي (صورة + نبذة Bio)
3. الأوامر الأساسية Basic Commands
إنشاء مستودع جديد
Terminalgit init
# انتقل إلى مجلد مشروعك
cd my-project
# حوّل المجلد إلى مستودع Git
git init
# Initialized empty Git repository in /my-project/.git/
# الآن يتتبّع Git كل تغيير في هذا المجلد
ملاحظة
الأمر git init يُنشئ مجلدًا مخفيًا اسمه .git - وهو يحتوي على سجل المشروع بالكامل. لا تحذفه!
معرفة حالة المشروع - git status
Terminalgit status
git status
# الحالات الممكنة:
# Untracked files → ملفات جديدة لا يعرفها Git
# Modified → ملفات تم تعديلها
# Staged → ملفات جاهزة للـ commit
# Nothing to commit → كل شيء محفوظ
إضافة الملفات إلى منطقة التجهيز - git add
Terminalgit add
# إضافة ملف واحد
git add index.html
# إضافة عدة ملفات
git add index.html style.css script.js
# إضافة جميع الملفات المعدّلة والجديدة
git add .
# إضافة جميع الملفات من نوع معيّن
git add *.html
حفظ التغييرات - git commit
Terminalgit commit
# الحفظ مع رسالة وصفية
git commit -m "add homepage HTML structure"
# إضافة + حفظ بأمر واحد (للملفات المتتبَّعة فقط)
git commit -am "fix navigation links"
كيف تكتب رسالة Commit جيدة؟
- - ابدأ بفعل:
add، fix، update، remove، refactor
- - كن محددًا: "fix login button color" وليس "fix stuff"
- - اكتبها بالإنجليزية (عُرف متّبع عالميًا)
- - اجعلها قصيرة: أقل من 50 حرفًا
عرض السجل - git log
Terminalgit log
# عرض جميع الـ commits
git log
# عرض مختصر (سطر واحد لكل commit)
git log --oneline
# عرض آخر 5 commits
git log --oneline -5
# العرض مع رسم بياني للفروع
git log --oneline --graph --all
عرض التغييرات - git diff
Terminalgit diff
# عرض التغييرات غير المُجهّزة (قبل git add)
git diff
# عرض التغييرات المُجهّزة (بعد git add)
git diff --staged
# عرض التغييرات في ملف معيّن
git diff index.html
التراجع عن التغييرات
Terminalالتراجع عن التغييرات
# إلغاء تغييرات ملف (قبل git add)
git checkout -- index.html
# إزالة ملف من منطقة التجهيز (بعد git add)
git reset HEAD index.html
# التراجع عن آخر commit (مع الاحتفاظ بالتغييرات)
git reset --soft HEAD~1
# الرجوع إلى commit معيّن (استخدمه بحذر!)
git checkout abc1234
تحذير
الأوامر التي تحذف التغييرات (مثل git reset --hard) لا يمكن التراجع عنها! استخدمها بحذر.
ملف .gitignore
ملف يخبر Git بتجاهل ملفات معيّنة (أي عدم تتبّعها):
.gitignoreملفات يتم تجاهلها
# ملفات النظام
.DS_Store
Thumbs.db
# مجلدات المكتبات (Dependencies)
node_modules/
vendor/
# ملفات البيئة (تحتوي على كلمات مرور!)
.env
.env.local
# ملفات مؤقتة
*.log
*.tmp
# مجلد البناء (Build)
dist/
build/
4. GitHub المنصة السحابية
ما هو GitHub؟
- منصة لتخزين مشاريع Git على الإنترنت (السحابة - Cloud)
- تتيح العمل الجماعي مع مطوّرين آخرين
- تعمل كملف أعمال (Portfolio) لأعمالك البرمجية
- تتضمن أدوات مثل: Issues وPull Requests وActions وPages
إنشاء مستودع على GitHub
اذهب إلى GitHub واضغط على "+" ثم "New repository"
اختر اسمًا للمشروع (مثلًا: my-portfolio)
اختر عام (Public) أو خاص (Private)
اختر "Add a README file" + "Add .gitignore"
اضغط على "Create repository"
واجهة GitHub
- Code: ملفات المشروع + عارض الكود
- Issues: تتبّع الأخطاء والمهام
- Pull Requests: طلبات دمج الكود
- Actions: الأتمتة (CI/CD)
- Settings: إعدادات المشروع
- README.md: وصف المشروع (أول ما يراه الزوّار)
5. العمل مع المستودع البعيد (Remote) ربط GitHub بجهازك
الطريقة 1: الاستنساخ (Clone) - نسخ مشروع من GitHub
إذا كان المشروع موجودًا على GitHub وتريد تنزيله إلى جهازك:
Terminalgit clone
# نسخ مشروع من GitHub إلى جهازك
git clone https://github.com/username/project-name.git
# الدخول إلى المجلد
cd project-name
# الآن المشروع على جهازك ومرتبط بـ GitHub تلقائيًا
الطريقة 2: ربط مشروع محلي بـ GitHub
إذا كان لديك مشروع على جهازك وتريد رفعه إلى GitHub:
Terminalربط مشروع موجود
# 1. أنشئ مستودعًا فارغًا على GitHub (بدون README)
# 2. داخل مجلد مشروعك على جهازك:
git init
git add .
git commit -m "initial commit"
# 3. اربط المشروع بـ GitHub
git remote add origin https://github.com/username/project.git
# 4. ارفع الكود
git push -u origin main
رفع التغييرات وسحبها
Terminalpush & pull
# رفع التغييرات من جهازك إلى GitHub
git push
# أول رفع لفرع جديد
git push -u origin main
# سحب التغييرات من GitHub إلى جهازك
git pull
# عرض المستودعات البعيدة المرتبطة
git remote -v
جهازك
git push →
GitHub
← git pull
جهاز زميلك
6. الفروع Branches
ما هي الفروع؟
تسمح لك الفروع (Branches) بالعمل على ميزة جديدة أو إصلاح خطأ دون التأثير على الكود الأصلي (main).
main: o---o---o-----------o---o (original code)
\ /
feature: o---o---o---o (new feature)
أوامر الفروع
Terminalالفروع
# عرض جميع الفروع
git branch
# إنشاء فرع جديد
git branch feature-navbar
# الانتقال إلى فرع
git checkout feature-navbar
# إنشاء + انتقال بأمر واحد
git checkout -b feature-navbar
# أو بالطريقة الحديثة
git switch -c feature-navbar
# الرجوع إلى main
git checkout main
# دمج فرع داخل main
git checkout main
git merge feature-navbar
# حذف فرع (بعد الدمج)
git branch -d feature-navbar
حل تعارضات الدمج (Merge Conflicts)
عندما تعدّل أنت وزميلك السطر نفسه في الملف نفسه، لا يستطيع Git الدمج تلقائيًا:
ملف فيه تعارضMerge Conflict
<h1>
<<<<<<< HEAD
Welcome to our website <-- تعديلك أنت
=======
Hello and welcome to the site <-- تعديل زميلك
>>>>>>> feature-branch
</h1>
الحل: احذف علامات التعارض، واختر النص الصحيح، ثم نفّذ git add . و git commit
7. سير العمل اليومي Daily Workflow
سير العمل المثالي لكل مشروع
Terminalسير العمل اليومي
# === بداية العمل ===
# 1. اسحب آخر التحديثات
git pull
# 2. أنشئ فرعًا للميزة التي تريد العمل عليها
git checkout -b feature-contact-form
# 3. اعمل على الكود... عدّل... أضف...
# 4. شاهد ما الذي تغيّر
git status
git diff
# 5. أضف التغييرات
git add .
# 6. احفظ (commit)
git commit -m "add contact form with validation"
# 7. ارفع إلى GitHub
git push -u origin feature-contact-form
# 8. على GitHub: افتح Pull Request لدمج الفرع في main
# === بعد الدمج ===
git checkout main
git pull
git branch -d feature-contact-form
طلب الدمج (Pull Request)
بدلًا من الدمج مباشرة في main، تُنشئ طلب دمج (Pull Request) على GitHub:
ارفع فرعك إلى GitHub باستخدام git push
على GitHub: اضغط على "Compare & pull request"
اكتب وصفًا للتغييرات التي أجريتها
يراجع زملاؤك الكود (مراجعة الكود - Code Review)
بعد الموافقة: اضغط على "Merge pull request"
README.md - وصف المشروع
يجب أن يحتوي كل مشروع على ملف README.md يشرح ما يلي:
README.mdMarkdown
# Project Name
A short description of the project
## Features
- Feature 1
- Feature 2
## Installation
```
git clone https://github.com/user/project.git
cd project
```
## Technologies Used
- HTML5
- CSS3
- JavaScript
## Developer
**Your Name** - [GitHub](https://github.com/username)
8. مرجع الأوامر Commands Reference
| الأمر |
الوصف |
مثال |
git init |
إنشاء مستودع جديد |
git init |
git clone |
نسخ مشروع من GitHub |
git clone URL |
git status |
عرض حالة الملفات |
git status |
git add |
الإضافة إلى منطقة التجهيز |
git add . |
git commit |
حفظ التغييرات |
git commit -m "msg" |
git push |
الرفع إلى GitHub |
git push origin main |
git pull |
السحب من GitHub |
git pull |
git log |
عرض السجل |
git log --oneline |
git diff |
عرض التغييرات |
git diff |
git branch |
إدارة الفروع |
git branch -a |
git checkout |
الانتقال إلى فرع |
git checkout -b name |
git merge |
دمج فرع |
git merge feature |
git remote |
إدارة المستودعات البعيدة |
git remote -v |
git stash |
تخزين التغييرات مؤقتًا |
git stash / git stash pop |