الدرس 2 من 10

اكتمل 20%

الإعداد والخطوات الأولى

ثبّت Git على نظامك، وقم بإعداد بيئتك، وأنشئ أول مستودع محلي لك.

الإعداد والخطوات الأولى

الآن وقد فهمت المفاهيم الأساسية في Git، حان الوقت لتثبيته وإعداده على نظامك. سيرشدك هذا الدرس خلال التثبيت والإعداد الأولي وإنشاء أول مستودع Git لك.

تثبيت Git

Windows

الخيار 1: التنزيل المباشر

زر الموقع git-scm.com
نزّل النسخة المناسبة (32 بت أو 64 بت)
شغّل برنامج التثبيت واتبع التعليمات

الخيار 2: Chocolatey

# Installer Chocolatey d'abord si nécessaire
choco install git

الخيار 3: Winget

winget install --id Git.Git -e --source winget

macOS

الخيار 1: Homebrew (موصى به)

# Installer Homebrew d'abord si nécessaire
brew install git

الخيار 2: MacPorts

sudo port install git

الخيار 3: التنزيل المباشر

زر الموقع git-scm.com

Linux

Ubuntu/Debian

sudo apt update
sudo apt install git

CentOS/RHEL/Fedora

# CentOS/RHEL
sudo yum install git

# Fedora
sudo dnf install git

Arch Linux

sudo pacman -S git

التحقق من التثبيت

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

git --version

يجب أن ترى شيئًا مثل:

git version 2.41.0

الإعداد الأولي

الإعداد العام الإلزامي

يتطلب Git كحد أدنى اسمك وبريدك الإلكتروني حتى يعمل:

# Configurer votre nom
git config --global user.name "Votre Nom"

# Configurer votre email
git config --global user.email "votre.email@example.com"

إعداد المحرر الافتراضي

# Visual Studio Code
git config --global core.editor "code --wait"

# Vim
git config --global core.editor "vim"

# Nano
git config --global core.editor "nano"

# Notepad++ (Windows)
git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"

إعداد نهايات الأسطر

Windows

git config --global core.autocrlf true

macOS/Linux

git config --global core.autocrlf input

إعداد الألوان

# Activer la coloration syntaxique
git config --global color.ui auto

إعداد الفرع الافتراضي

# Utiliser 'main' comme nom de branche par défaut
git config --global init.defaultBranch main

التحقق من الإعداد

اعرض إعدادك الحالي:

# Voir toute la configuration
git config --list

# Voir une configuration spécifique
git config user.name
git config user.email

مستويات الإعداد

يستخدم Git ثلاثة مستويات للإعداد:

1. إعداد النظام (—system)

يؤثر في جميع مستخدمي النظام
الملف: /etc/gitconfig (Linux/macOS) أو C:\Program Files\Git\etc\gitconfig (Windows)

2. الإعداد العام (—global)

يؤثر في المستخدم الحالي
الملف: ~/.gitconfig أو ~/.config/git/config

3. الإعداد المحلي (—local)

يؤثر في المستودع الحالي فقط
الملف: .git/config داخل المستودع

أولوية الإعدادات

المحلي > العام > النظام

إنشاء أول مستودع لك

الطريقة 1: تهيئة مستودع جديد

# Créer un nouveau dossier
mkdir mon-premier-projet
cd mon-premier-projet

# Initialiser le dépôt Git
git init

الطريقة 2: استنساخ مستودع موجود

# Cloner depuis GitHub
git clone https://github.com/utilisateur/depot.git

# Cloner avec un nom différent
git clone https://github.com/utilisateur/depot.git nouveau-nom

بنية مستودع Git

بعد التهيئة، يحتوي مجلدك على:

mon-premier-projet/
├── .git/           # Dossier Git (caché)
│   ├── config      # Configuration locale
│   ├── objects/    # Base de données des objets
│   ├── refs/       # Références (branches, tags)
│   └── HEAD        # Pointeur vers la branche actuelle
└── (vos fichiers)

أول commit

إنشاء ملف

# Créer un fichier README
echo "# Mon Premier Projet" > README.md

إضافة الملف إلى الفهرس

# Ajouter le fichier à la staging area
git add README.md

# Ou ajouter tous les fichiers
git add .

إنشاء الـ commit

# Créer le premier commit
git commit -m "Premier commit : ajout du README"

التحقق من السجل

# Voir l'historique des commits
git log

# Version condensée
git log --oneline

الإعداد المتقدم

اختصارات (Aliases) مفيدة

# Raccourcis pour les commandes courantes
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.unstage 'reset HEAD --'
git config --global alias.last 'log -1 HEAD'
git config --global alias.visual '!gitk'

إعداد merge وrebase

# Stratégie de merge par défaut
git config --global merge.tool vimdiff

# Comportement du pull
git config --global pull.rebase false  # merge (par défaut)
# git config --global pull.rebase true   # rebase
# git config --global pull.ff only       # fast-forward seulement

إعداد توقيع GPG (اختياري)

# Configurer la clé GPG
git config --global user.signingkey YOUR_GPG_KEY_ID

# Signer tous les commits par défaut
git config --global commit.gpgsign true

مثال على ملف .gitconfig

إليك مثالًا على ملف .gitconfig مُعدّ جيدًا:

[user]
    name = Votre Nom
    email = votre.email@example.com

[core]
    editor = code --wait
    autocrlf = true  # Windows
    # autocrlf = input  # macOS/Linux

[init]
    defaultBranch = main

[color]
    ui = auto

[alias]
    st = status
    co = checkout
    br = branch
    ci = commit
    unstage = reset HEAD --
    last = log -1 HEAD
    lg = log --oneline --graph --decorate --all

[pull]
    rebase = false

[push]
    default = simple

تمارين عملية

التمرين 1: إعداد كامل

تحقق من تثبيت Git لديك
اضبط اسمك وبريدك الإلكتروني
اضبط محررك المفضل
أنشئ بعض الاختصارات (aliases) المفيدة
تحقق من إعدادك

التمرين 2: أول مستودع

أنشئ مجلدًا جديدًا لمشروع
هيّئ مستودع Git
أنشئ ملف README.md يتضمن وصفًا
أضف الملف إلى الفهرس
أنشئ أول commit لك
تحقق من السجل

التمرين 3: الاستكشاف

# Créer plusieurs fichiers
touch index.html style.css script.js

# Ajouter du contenu
echo "<h1>Mon Site Web</h1>" > index.html
echo "body { font-family: Arial; }" > style.css
echo "console.log('Hello World!');" > script.js

# Ajouter et commiter
git add .
git commit -m "Ajout des fichiers de base du site web"

# Explorer l'historique
git log --oneline
git show HEAD

حل المشكلات الشائعة

المشكلة: “Author identity unknown”

# Solution : configurer nom et email
git config --global user.name "Votre Nom"
git config --global user.email "votre.email@example.com"

المشكلة: المحرر لا يُفتح

# Vérifier la configuration
git config --global core.editor

# Reconfigurer si nécessaire
git config --global core.editor "code --wait"

المشكلة: نهايات الأسطر في Windows

# Configuration recommandée pour Windows
git config --global core.autocrlf true

الأدوات الرسومية الموصى بها

المجانية

GitHub Desktop: بسيط وفعّال
SourceTree: شامل واحترافي
GitKraken: واجهة حديثة (النسخة المجانية محدودة)

المدمجة في بيئات التطوير (IDE)

VS Code: إضافة Git مدمجة
IntelliJ IDEA: دعم أصلي لـ Git
Eclipse: إضافة EGit

أفضل الممارسات في الإعداد

استخدم الاختصارات (aliases) للأوامر المتكررة
اضبط محررًا تتقنه
فعّل الألوان لقراءة أفضل
اضبط نهايات الأسطر بحسب نظام التشغيل لديك
استخدم اسم فرع افتراضي موحدًا (main)

موارد إضافية

التوثيق

أدوات الإعداد

الخلاصة

تهانينا! أصبح لديك الآن Git مثبّتًا ومُعدًّا على نظامك. لقد أنشأت أول مستودع لك ونفّذت أول commit. ستتيح لك هذه الأسس المتينة استكشاف الميزات الأكثر تقدمًا في Git.

في الدرس القادم، سنتعرف على أوامر Git الأساسية التي ستستخدمها يوميًا لإدارة مشاريعك.

وقت القراءة المقدّر: 20 دقيقة
المستوى: مبتدئ
الخطوة السابقة: مقدمة إلى Git
الخطوة التالية: أوامر Git الأساسية