إتقان أساسيات Git: الدليل الكامل لعام

ملخص

• Git هو نظام تحكم إصدارات موزع يتعقب التغييرات في كود المصدر بكفاءة وأمان.
• تعلم كيفية تهيئة المستودعات، stage commits، branch، merge، وحل النزاعات مثل المحترف.
• افهم متى تستخدم Git مقارنة بأنظمة تحكم الإصدارات الأخرى.
• استكشف سير العمل الحقيقي المستخدم من قبل شركات التكنولوجيا الكبرى.
• احصل على خبرة عملية في استكشاف الأخطاء وممارسات الأمان وتحسين الأداء.

---

ما ستتعلمه

1. البنية الأساسية لـ Git — كيفية تعقب التغييرات وإدارة التاريخ.
2. الأوامر الأساسية للتطوير اليومي: git init, git add, git commit, git push, وغيرها.
3. استراتيجيات branching و merging لسير العمل التعاوني.
4. الأخطاء الشائعة التي يواجهها المطورون وكيفية إصلاحها.
5. كيفية هيكلة سير عمل Git من قبل الفرق الكبيرة (مثل Netflix أو Stripe).
6. أفضل الممارسات للأمان والأداء والقابلية للتوسع في مشاريع تعتمد على Git.

---

المتطلبات الأساسية

• معرفة أساسية بسطر الأوامر.
• الاطلاع على مفاهيم البرمجة (لا يتطلب لغة محددة).
• تثبيت Git (الإصدار 2.40+ موصى به¹).

للتحقق من تثبيت Git:

git --version

الإخراج المتوقع:

git version 2.44.0

---

مقدمة: لماذا يهم Git

Git ليس مجرد أداة للمطورين — بل هو أساس التعاون البرمجي الحديث. تم إنشاؤه بواسطة لينوس تورفالدز في عام 2005 لإدارة نواة لينكس², غيّر Git طريقة تتبع الفرق للتغييرات في الكود. على عكس الأنظمة المركزية مثل Subversion (SVN), Git موزع: كل مطور لديه نسخة كاملة من المستودع، بما في ذلك تاريخه.

هذا يعني أنه يمكنك:

• العمل دون اتصال.
• التجربة بأمان مع الفروع.
• الرجوع إلى أي حالة سابقة.
• التعاون بشكل غير متزامن عبر المناطق الزمنية.

تعتمد الشركات الكبرى — من Google إلى Microsoft — على Git لتنسيق قواعد الكود الضخمة³.

---

أساسيات Git

كيف يعمل Git من الداخل

يقوم Git بتخزين البيانات كسلسلة من اللقطات، وليس الفروق. كل commit يمثل الحالة الكاملة لمشروعك في لحظة معينة. عندما لا يتغير شيء، يعيد Git استخدام البيانات الموجودة، مما يجعله فعالًا للغاية.

مكونات Git الأساسية:

• Repository (repo): قاعدة بيانات تاريخ مشروعك.
• Commit: لقطة لمشروعك في نقطة معينة.
• Branch: مؤشر قابل للتحريك إلى commit.
• HEAD: مرجع الفرع الحالي.
• Index (staging area): منطقة تحضير للالتزام التالي.

سير عمل Git الأساسي

flowchart LR
  A[Working Directory] -->|git add| B[Staging Area]
  B -->|git commit| C[Local Repository]
  C -->|git push| D[Remote Repository]

شرح التدفق:

1. قم بتعديل الملفات في دليل العمل الخاص بك.
2. قم بتحضير التغييرات باستخدام git add.
3. قم بعمل commit للتغييرات المحضرة مع رسالة.
4. قم بـ push commits إلى مستودع بعيد (مثل GitHub, GitLab).

---

بدء سريع: التشغيل في 5 دقائق

1. تهيئة مستودع:

   git init my-project
   cd my-project
   

2. إضافة ملف والالتزام:

   echo "Hello Git" > README.md
   git add README.md
   git commit -m "Initial commit"
   

3. الاتصال بمستودع بعيد:

   git remote add origin https://GitHub.com/username/my-project.git
   git push -u origin main
   

4. فحص الحالة:

   git status
   

---

مقارنة: Git مقابل أنظمة تحكم الإصدارات الأخرى

الميزة	Git	Subversion (SVN)	Mercurial
الهيكل	موزع	مركزي	موزع
العمل دون اتصال	✅	❌	✅
الفرع	خفيف	مكلف	خفيف
نزاعات الدمج	مُعالجة بكفاءة	معقدة	فعالة
دعم المجتمع	كبير جدًا	متوسط	متوسط
الأداء على المستودعات الكبيرة	ممتاز4	أبطأ	جيد

---

الفرع والدمج

الفرع هو أحد قوى Git الخارقة. يسمح لك بعزل الميزات أو إصلاح الأخطاء أو التجارب.

إنشاء وتبديل الفروع

git branch feature/login
git checkout feature/login

أو بأمر واحد:

git checkout -b feature/login

دمج الفروع

بعد إكمال الميزة:

git checkout main
git merge feature/login

إذا حدثت تعارضات، سيقوم Git بتحديدها في ملفاتك. قم بحلها يدويًا، ثم:

git add .
git commit -m "Resolve merge conflicts"

Rebase مقابل Merge

العملية	الوصف	حالة الاستخدام
merge	يجمع السجلات، مع الحفاظ على commits	العمل التعاوني
rebase	يعيد كتابة التاريخ، وإنشاء خط زمني خطي	سياقات عمل نظيفة للمطور الواحد

قبل (merge):

*   Merge branch 'feature'
|\  
| * Commit on feature
* | Commit on main

بعد (rebase):

* Commit on main
* Commit on feature (rebased)

---

مثال واقعي: Git at Scale

تتبنى المنظمات الكبيرة نمط عمل يعتمد على Git مثل GitFlow أو Trunk-Based Development⁵. للإشارة:

• GitFlow: مثالي للفِرق التي تعتمد على الإصدارات، مع فروع منفصلة للميزات والإصدارات والتصحيحات العاجلة.
• Trunk-Based Development: شائع في بيئات النشر المستمر، حيث يقوم المطورون بالالتزام مباشرة إلى main باستخدام علامات الميزات.

تتيح هذه الأنماط للفرق الحفاظ على الاستقرار مع تسليم سريع — توازن حاسم في الأنظمة التي تعمل على نطاق الإنتاج.

---

متى تستخدم مقابل متى لا تستخدم Git

السيناريو	استخدم Git	تجنب Git
تطوير البرمجيات	✅
المشاريع المفتوحة المصدر التعاونية	✅
تخزين ملفات ثنائية كبيرة		❌ (استخدم Git LFS أو artifact storage)
إصدار ملفات نصية صغيرة	✅
التحرير التعاوني في الوقت الحقيقي		❌ (استخدم Google Docs أو ما يشبهه)

يتميز Git بفعالية في إصدار الكود والملفات النصية. لكن بالنسبة للملفات الثنائية الضخمة أو التحرير في الوقت الحقيقي، فهو ليس الأداة المناسبة.

---

الأخطاء الشائعة والحلول

مشكلة	السبب	الحل
Detached HEAD	تمت مراجعة commit بدلاً من branch	git checkout main
Merge conflicts	تعديلات متداخلة	قم بحلها يدويًا، ثم git add + git commit
Lost commits	force push أو rebase خاطئ	استعادة باستخدام git reflog

مثال: Recovering Lost Commits

git reflog
# Find commit hash
git checkout <commit_hash>

---

الاعتبارات الأمنية

تحتوي مستودعات Git على بيانات حساسة — API مفاتيح، بيانات اعتماد، أو كود خاص. اتبع أفضل الممارسات التالية:

1. استخدم .gitignore لاستبعاد الأسرار وbuild artifacts.
2. امسح عن الأسرار باستخدام أدوات مثل gitleaks أو trufflehog.
3. وقّع الالتزامات باستخدام GPG للتحقق من الأصالة:

   git config --global user.signingkey <your-key-id>
   git commit -S -m "Signed commit"
   

4. راجع تحكم الوصول على المستودعات البعيدة (خاصة المستودعات العامة GitHub).

للامتثال، تذكر أن تاريخ Git غير قابل للتغيير — بمجرد التزام البيانات الحساسة، يصعب إزالتها. استخدم git filter-repo لإعادة كتابة التاريخ بأمان⁶.

---

الأداء والقابلية للتوسع

تم تصميم Git للسرعة والقابلية للتوسع الموزعة. ومع ذلك، قد ينخفض الأداء في المستودعات الكبيرة جدًا.

نصائح التحسين:

• استخدم نسخ ضحلة (git clone --depth 1) لخطوط أنابيب CI/CD.
• قم بتمكين ضغط دلتا (git gc --aggressive).
• استخدم النسخ الجزئي للمستودعات الكبيرة (git clone --filter=blob:none).

تقلل هذه الميزات بشكل كبير من استخدام القرص وأوقات النسخ في بيئات المؤسسات⁷.

---

الاختبارات وتكامل CI/CD

يتكامل Git بسلاسة مع أنظمة التكامل المستمر مثل GitHub Actions، GitLab CI، أو Jenkins.

مثال GitHub Actions workflow:

name: Run Tests
on: [push, pull_request]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      - name: Install dependencies
        run: pip install -r requirements.txt
      - name: Run tests
        run: pytest --maxfail=1 --disable-warnings -q

هذا يضمن أن كل commit يُشغّل اختبارات تلقائية — ضروري للجاهزية للإنتاج.

---

أنماط معالجة الأخطاء

عند العمل مع Git في السكريبتات أو أنابيب CI، تعامل مع الأخطاء بسلاسة:

if ! git pull --rebase; then
  echo "Rebase failed, aborting..."
  git rebase --abort
  exit 1
fi

هذا يمنع انتشار عمليات دمج تالفة إلى عمليات إنتاج.

---

المراقبة والقابلية للملاحظة

بينما Git نفسه لا يحتوي على أدوات ملاحظة، يمكنك مراقبة صحة المستودع باستخدام:

• GitHub Insights: commit frequency, contributor activity.
• GitLab Analytics: Merge request metrics.
• Custom scripts: Use git log --stat or git shortlog for trend analysis.

مثال:

git log --since="1 month ago" --pretty=format:"%an" | sort | uniq -c | sort -nr

الإخراج:

42  Alice
30  Bob
12  Carol

هذا يساعد في تحديد أنماط نشاط المساهمين.

---

الأخطاء الشائعة التي يرتكبها الجميع

1. Committing large binaries: يبطئ عمليات النسخ — استخدم Git LFS.
2. نسيان .gitignore: يؤدي إلى وجود ملفات غير ضرورية في السجل.
3. Force pushing shared branches: يُعيد كتابة عمل الزملاء.
4. تجاهل تعارضات الدمج: يسبب أخطاء في البناء.
5. عدم كتابة commit messages وصفية: يجعل السجل غير قابل للقراءة.

---

دليل استكشاف الأخطاء وإصلاحها

Error Message	Possible Cause	Fix
fatal: not a git repository	غياب دليل .git	قم بتشغيل git init
Permission denied (publickey)	مفتاح SSH غير مُهيأ	أضف مفتاح SSH إلى GitHub/GitLab
Merge conflict in <file>	تعديلات متزامنة	حل يدويًا، ثم commit
fatal: refusing to merge unrelated histories	مصدر مستودع مختلف	استخدم --allow-unrelated-histories

---

تحدي جربه بنفسك

1. أنشئ مستودعًا محليًا جديدًا.
2. أضف فرعين: feature/API و feature/ui.
3. قم بإجراء تغييرات متضاربة على نفس الملف.
4. دمجها وحل التعارضات يدويًا.
5. ادفع إلى المستودع البعيد وافتح طلب سحب.

هذا التمرين سيساعدك على فهم الفروع، الدمج، وحل التعارضات بعمق.

---

النقاط الرئيسية

Git أكثر من مجرد أداة — إنه عقلية.

• تعلم commit مبكرًا ومتكررًا.
• اكتب رسائل commit ذات معنى.
• استخدم branches بحكمة.
• أتمتة الاختبارات والمراجعات.
• احمي سجلك — إنه DNA مشروعك.

---

الأسئلة الشائعة

س1: ما الفرق بين git pull و git fetch؟
git fetch يُنزّل التغييرات لكنه لا يدمجها. git pull يقوم بالاثنين.

س2: كيف أتراجع عن آخر commit؟
استخدم git reset --soft HEAD~1 لإلغاء الالتزام مع الاحتفاظ بالتغييرات مؤقتة.

س3: هل يمكنني استخدام Git بدون GitHub؟
بالتأكيد. Git يعمل محليًا أو مع أي خادم بعيد.

س4: كيف أتعامل مع الملفات الكبيرة؟
استخدم Git Large File Storage (Git LFS).

س5: هل Git مناسب للموارد الثنائية مثل الصور أو الفيديوهات؟
ليس بشكل مثالي — استخدم تخزين متخصص أو LFS.

---

الخطوات التالية

• استكشف مواضيع متقدمة مثل GitFlow، و workflows Rebase، و Submodules.
• إعداد pre-commit hooks لفحص الكود.
• دمج Git مع CI/CD pipeline.

---

الهوامش

1. توثيق Git – التثبيت والتهيئة: https://git-scm.com/docs ↩

2. لينوس تورفالدز، تاريخ Git – https://git-scm.com/about ↩

3. مدونة Microsoft Dev – تبني Git على نطاق واسع: https://devblogs.microsoft.com/devops/why-microsoft-switched-to-git/ ↩

4. ملاحظات أداء Git – https://git-scm.com/docs/git-fast-import ↩

5. دروس Atlassian Git – أنماط العمل: https://www.atlassian.com/git/tutorials/comparing-workflows ↩

6. توثيق Git Filter-Repo – https://GitHub.com/newren/git-filter-repo ↩

7. توثيق Git Partial Clone – https://git-scm.com/docs/partial-clone ↩