الدليل الشامل لـ Git: من الأساسيات إلى الاحتراف

# بعد التثبيت، تأكد من نجاح العملية
git --version
# يجب أن يظهر رقم الإصدار، مثال: git version 2.45.0

# تحديث قائمة الحزم
sudo apt update

# تثبيت Git
sudo apt install git

# التحقق من التثبيت
git --version

# تثبيت Homebrew أولاً (إذا لم يكن مثبتاً)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# تثبيت Git عبر Homebrew
brew install git

# التحقق
git --version

# إعداد الاسم
git config --global user.name "اسمك الكامل"

# إعداد البريد الإلكتروني (استخدم نفس البريد المسجل في GitHub)
git config --global user.email "your.email@example.com"

# التحقق من الإعدادات
git config --list

# تلوين مخرجات Git
git config --global color.ui auto

# محرر النصوص الافتراضي
git config --global core.editor "code --wait"

# أداة دمج الفروع الافتراضية
git config --global init.defaultBranch main

# استخدام rebase عند السحب
git config --global pull.rebase true

# ضغط الملفات الكبيرة
git config --global core.compression 9

# انتقل إلى مجلد مشروعك
cd path/to/your/project

# إنشاء مستودع Git جديد
git init

# التحقق من إنشاء المجلد المخفي .git
ls -la | grep .git

# إنشاء ملف .gitignore
touch .gitignore

# أو استخدم محرر النصوص
code .gitignore

# مجلدات النظام
.DS_Store
Thumbs.db

# مجلدات Node.js
node_modules/
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# ملفات البيئة
.env
.env.local
.env.*.local

# مجلدات البناء
dist/
build/
*.min.js
*.min.css

# محررات النصوص
.vscode/
.idea/
*.swp
*.swo

# ملفات السجلات
*.log
logs/

# ملفات مؤقتة
*.tmp
*.temp

# نسخ مستودع عبر HTTPS
git clone https://github.com/username/repository.git

# نسخ مستودع عبر SSH (موصى به)
git clone git@github.com:username/repository.git

# نسخ مع تحديد اسم المجلد
git clone https://github.com/username/repo.git my-project

# نسخ فرع محدد فقط
git clone --branch develop https://github.com/username/repo.git

# عرض الحالة المفصلة
git status

# عرض مختصر
git status -s

# إضافة ملف محدد
git add filename.js

# إضافة جميع الملفات المعدلة والجديدة
git add .

# إضافة جميع الملفات المعدلة فقط (لا يشمل الجديدة)
git add -u

# إضافة ملفات محددة بنمط
git add *.js
git add src/**/*.ts

# إضافة تفاعلية (اختيار أجزاء محددة من ملف)
git add -p

# إزالة ملف من المرحلة التحضيرية
git reset HEAD filename.js

# commit مع رسالة مباشرة
git commit -m "feat: add user authentication module"

# commit سريع للإضافات المعدلة فقط (بدون git add)
git commit -am "fix: resolve login bug"

# تعديل آخر commit
git commit --amend -m "feat: add user authentication module with tests"

# commit مع تفصيل أكثر
git commit -m "feat: add user authentication" -m "This includes:
- Login endpoint
- JWT token generation
- Password hashing
- Unit tests"

# سجل commits الكامل
git log

# سجل مختصر (سطر واحد لكل commit)
git log --oneline

# سجل مع الرسم البياني للفروع
git log --oneline --graph --all

# آخر 10 commits
git log -n 10

# commits منذ تاريخ معين
git log --since="2024-01-01" --until="2024-12-31"

# commits لمؤلف معين
git log --author="username"

# commits تحتوي كلمة في الرسالة
git log --grep="authentication"

# commits في ملف محدد
git log -- path/to/file.js

# إحصائيات commits
git log --stat

# عرض التغييرات في كل commit
git log -p

# تنسيق مخصص
git log --pretty=format:"%h - %an, %ar : %s"

# إنشاء فرع جديد
git branch feature-login

# التبديل لفرع آخر
git checkout feature-login

# أو الطريقة الأحدث (Git 2.23+)
git switch feature-login

# إنشاء فرع والتبديل إليه فوراً
git checkout -b feature-login
# أو
git switch -c feature-login

# إنشاء فرع من commit معين
git checkout -b feature-from-hash a1b2c3d

# عرض جميع الفروع المحلية
git branch

# عرض جميع الفروع (محلية وبعيدة)
git branch -a

# عرض الفرع الحالي
git branch --show-current

# حذف فرع محلي
git branch -d feature-login

# حذف فرع بالقوة (حتى لو لم يُدمج)
git branch -D feature-login

# إعادة تسمية فرع
git branch -m old-name new-name

# التبديل للفرع المستهدف
git checkout main
# أو
git switch main

# سحب آخر التحديثات
git pull origin main

# دمج الفرع
git merge feature-login

# دمج بدون fast-forward (لحفظ تاريخ الفرع)
git merge --no-ff feature-login

# دمج مع squashing (دمج كل commits في واحد)
git merge --squash feature-login

<<<<<<< HEAD
هذا الكود من الفرع الحالي (main)
=======
هذا الكود من الفرع المدمج (feature)
>>>>>>> feature-login

# بعد حل التعارضات يدوياً
git add .
git commit -m "fix: resolve merge conflicts"

# أو إلغاء الدمج والعودة للحالة السابقة
git merge --abort

# rebase على الفرع الرئيسي
git checkout feature-login
git rebase main

# rebase تفاعلي (لإعادة ترتيب أو تعديل commits)
git rebase -i HEAD~5

# إلغاء rebase جاري
git rebase --abort

# متابعة rebase بعد حل التعارضات
git rebase --continue

# إضافة مستودع بعيد
git remote add origin https://github.com/username/repo.git

# عرض المستودعات البعيدة
git remote -v

# تغيير رابط مستودع بعيد
git remote set-url origin https://github.com/username/new-repo.git

# إزالة مستودع بعيد
git remote remove origin

# فحص مستودع بعيد
git remote show origin

# رفع الفرع الحالي إلى البعيد لأول مرة
git push -u origin main

# رفع عادي
git push

# رفع فرع محدد
git push origin feature-login

# رفع مع تعيين upstream
git push --set-upstream origin feature-login

# سحب التحديثات ودمجها
git pull

# سحب تحديثات فقط بدون دمج
git fetch

# سحب وتحديث كل الفروع
git fetch --all

# رفع بالقوة (استخدم بحذر!)
git push --force
# أو الأكثر أماناً
git push --force-with-lease

# حذف فرع بعيد
git push origin --delete feature-login

# استعادة ملف إلى حالته في آخر commit
git checkout -- filename.js
# أو
git restore filename.js

# استعادة جميع الملفات
git checkout -- .
# أو
git restore .

# إزالة ملفات غير متباعة من مجلد العمل
git clean -n    # عرض ما سيُحذف
git clean -f    # حذف فعلي
git clean -fd   # حذف ملفات ومجلدات

# التراجع عن آخر commit مع حفظ التغييرات في working directory
git reset --soft HEAD~1

# التراجع مع إبقاء التغييرات في staging
git reset --mixed HEAD~1  # (افتراضي)

# التراجع الكامل وحذف التغييرات
git reset --hard HEAD~1

# إنشاء commit جديد يعكس commit سابق (آمن للتعاون)
git revert <commit-hash>

# التراجع عن revert
git revert --no-commit HEAD

# بدء البحث
git bisect start

# تحديد commit يعرف أنه جيد
git bisect good a1b2c3d

# تحديد commit يعرف أنه سيء
git bisect bad HEAD

# Git سينقلك لمنتصف المسار، اختبر الكود ثم:
git bisect good   # إذا كان يعمل
# أو
git bisect bad    # إذا كان به خطأ

# كرر حتى يجد Git commit المشكلة

# إنهاء البحث
git bisect reset

# استعادة ملف من commit معين
git checkout <commit-hash> -- filename.js

# أو
git restore --source=<commit-hash> filename.js

# استعادة مجلد كامل
git checkout <commit-hash> -- folder/

# حفظ التغييرات مؤقتاً
git stash

# حفظ مع رسالة
git stash save "work in progress on feature"

# عرض كل stashes
git stash list

# استعادة آخر stash
git stash pop

# استعادة دون حذف من القائمة
git stash apply

# استعادة stash محدد
git stash apply stash@2

# حذف stash
git stash drop stash@1

# حذف كل stashes
git stash clear

# إنشاء فرع من stash
git stash branch new-branch stash@0

# إنشاء tag خفيف
git tag v1.0.0

# إنشاء tag annotated (موصى به)
git tag -a v1.0.0 -m "Release version 1.0.0"

# عرض كل tags
git tag

# عرض تفاصيل tag
git show v1.0.0

# رفع tag للبعيد
git push origin v1.0.0

# رفع كل tags
git push --tags

# حذف tag محلي
git tag -d v1.0.0

# حذف tag بعيد
git push origin --delete v1.0.0

# تطبيق commit محدد على الفرع الحالي
git cherry-pick <commit-hash>

# تطبيق عدة commits
git cherry-pick <hash1> <hash2>

# تطبيق نطاق commits
git cherry-pick A..B

# تطبيق دون commit تلقائي
git cherry-pick --no-commit <hash>

# إنشاء pre-commit hook
cat > .git/hooks/pre-commit << 'EOF'
#!/bin/sh

# فحص الكود قبل كل commit
echo "Running pre-commit checks..."

# فحص الـ linting
npm run lint

# تشغيل الاختبارات
npm test

echo "All checks passed!"
EOF

# جعله قابلاً للتنفيذ
chmod +x .git/hooks/pre-commit