دليل Git: ٠٣. فهم عملية إضافة الملفات إلى مرحلة التهيئة

git add .

المقدمة

يعد Git نظامًا قويًا للتحكم في الإصدارات، حيث يسمح للمطورين بتتبع التغييرات، والتعاون بكفاءة، والحفاظ على سير عمل منظم. من المفاهيم الأساسية في Git هي منطقة التهيئة (Staging Area)، والتي تعمل كخطوة وسيطة قبل تنفيذ الالتزامات (Commits) في المستودع.

في هذه المقالة، سنستعرض عملية إضافة الملفات إلى مرحلة التهيئة في Git، بما في ذلك أوامر git status، وطرق مختلفة لإضافة الملفات إلى منطقة التهيئة، بالإضافة إلى شرح الفرق بين دليل العمل (Working Directory)، ومنطقة التهيئة، والمستودع (Repository).

أهمية إضافة الملفات إلى مرحلة التهيئة

تتيح لك منطقة التهيئة (المعروفة أيضًا باسم الفهرس – Index) تحضير وتنظيم التغييرات قبل تنفيذها في التزام. على عكس أنظمة التحكم في الإصدارات الأخرى، يوفر Git هذه الخطوة الوسيطة، مما يمنحك تحكمًا أكبر في ما يتم تضمينه في كل التزام.

من خلال إضافة الملفات إلى منطقة التهيئة، يمكنك:

• تنفيذ التزامات دقيقة عبر إضافة تغييرات محددة فقط.
• تنظيم الالتزامات بشكل منطقي عن طريق تجميع التغييرات المتشابهة معًا.
• تجنب الالتزام بتعديلات غير مكتملة عبر تركها خارج التهيئة.

التحقق من حالة الملفات: git status و git status -s

قبل إضافة الملفات إلى منطقة التهيئة، من المهم التحقق من حالة الملفات باستخدام الأمر التالي:

1. git status

يُظهر هذا الأمر تقريرًا تفصيليًا عن حالة الملفات في دليل العمل:

git status

يعرض الأمر:

• الملفات غير المتعقبة (ملفات جديدة لم تتم إضافتها إلى Git بعد).
• الملفات المعدلة ولكن غير مضافة إلى التهيئة.
• الملفات التي تمت إضافتها إلى منطقة التهيئة وجاهزة للتنفيذ.
• معلومات حول الفرع الحالي.

مثال على ناتج git status:

On branch main
Untracked files:
  (use "git add <file>..." to include in what will be committed)
	file1.txt
	file2.txt

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
	modified:   script.py

2. git status -s (حالة مختصرة)

يتيح لك الخيار -s رؤية الحالة بشكل أكثر اختصارًا:

git status -s

مثال على ناتج git status -s:

?? file1.txt  # Untracked file
 M script.py  # Modified file but not staged
A  main.css   # Staged file ready for commit

دلالات الرموز:

• ?? → ملف غير متعقب.
• M → ملف معدل ولكنه غير مضاف إلى التهيئة.
• A → ملف تمت إضافته إلى التهيئة (جاهز للتنفيذ).

إضافة الملفات إلى منطقة التهيئة

1. إضافة ملف واحد

لإضافة ملف معين إلى منطقة التهيئة، استخدم:

git add file1.txt

سينقل هذا الملف من دليل العمل إلى منطقة التهيئة.

2. إضافة ملفات متعددة

يمكنك إضافة أكثر من ملف في نفس الوقت:

git add file1.txt file2.txt

سيتم نقل كلا الملفين إلى منطقة التهيئة.

3. إضافة ملفات باستخدام نمط معين (Wildcard *)

إذا كنت تريد إضافة جميع الملفات من نوع معين (مثل جميع الملفات النصية .txt)، استخدم:

git add *.txt

سيؤدي هذا إلى إضافة جميع الملفات النصية في الدليل الحالي إلى منطقة التهيئة.

4. إضافة جميع التعديلات في الدليل الحالي

لإضافة جميع الملفات المعدلة وغير المتعقبة دفعة واحدة:

git add .

يُستخدم هذا الأمر عندما تريد إضافة كل شيء بسرعة، ولكن كن حذرًا لأنه سيضيف أيضًا أي تغييرات غير مقصودة.

فهم سير العمل في Git: دليل العمل، منطقة التهيئة، والمستودع

1. دليل العمل (Working Directory)

دليل العمل هو المكان الذي يحتوي على جميع ملفات مشروعك. يمكن أن تكون الملفات في إحدى الحالات التالية:

• غير متعقبة (ملفات جديدة لم يتم إضافتها إلى Git بعد).
• معدلة (تم تغييرها ولكن لم يتم إضافتها إلى التهيئة).

2. منطقة التهيئة (Index)

تعد منطقة التهيئة بمثابة لقطة للملفات التي تريد تضمينها في الالتزام التالي. يجب إضافة الملفات هنا يدويًا باستخدام git add. إذا تم تعديل ملف بعد إضافته إلى التهيئة، يجب إضافته مرة أخرى قبل تنفيذ الالتزام.

3. المستودع (Repository)

بمجرد تنفيذ التزامات (Commits) الملفات المضافة إلى التهيئة، يتم تخزينها في المستودع كجزء من محفوظات المشروع. المستودع هو المكان الذي يتم فيه تسجيل جميع التعديلات ويمكنك الرجوع إليها في أي وقت.

ملخص سير العمل:

1. تعديل الملفات في دليل العمل → إجراء تغييرات على ملفات المشروع.
2. إضافة التعديلات إلى التهيئة (git add) → نقل التعديلات إلى منطقة التهيئة.
3. تنفيذ الالتزام (git commit -m "رسالة") → حفظ التعديلات بشكل دائم في المستودع.

تمثيل مرئي لسير العمل:

[دليل العمل] → (git add) → [منطقة التهيئة] → (git commit) → [المستودع]

الخاتمة

يعد فهم منطقة التهيئة في Git وكيفية استخدام git add بشكل صحيح أمرًا أساسيًا لإدارة التغييرات بكفاءة. من خلال استخدام أوامر مثل git status و git add و git commit، يمكنك التحكم في التعديلات التي يتم تنفيذها والحفاظ على سجل مشروع نظيف ومنظم.

إتقان هذه المفاهيم يساعد في تحسين سير العمل وضمان تعاون أفضل داخل الفرق.

🚀 برمجة سعيدة!