ما هو استخدام الأمر git log؟

يُعتبر git log أحد أكثر الأوامر شيوعًا واستخدامًا في نظام التحكم بالإصدار Git. يُتيح هذا الأمر للمطورين إمكانية عرض السجل الكامل لتاريخ المشروع، بما في ذلك جميع الالتزامات (Commits) التي أُجريت. يُوفر git log مرونة كبيرة من خلال الخيارات المتعددة التي تُمكِّنك من تخصيص عرض السجل بالطريقة التي تُناسب احتياجاتك.

ما هو الأمر git log؟

الأمر git log هو أداة تُستخدم لعرض تاريخ الالتزامات في مستودع Git. عندما تعمل في مشروع ما، فإن كل عملية تعديل أو تحديث يتم تسجيلها كـ التزام، وتحتوي كل التزام على معلومات مُحددة مثل:

• معرّف الالتزام (Commit Hash).
• اسم المؤلف (Author).
• البريد الإلكتروني للمؤلف.
• التاريخ والوقت الذي أُجري فيه الالتزام.
• رسالة الالتزام (Commit Message) التي توضح تفاصيل التغييرات.

استخدامات git log

يُستخدم الأمر git log بشكل أساسي لاستعراض السجل الكامل للتعديلات التي تمت على مستودع Git. يمكن للمطورين استخدامه لتحليل تاريخ المشروع، تتبع التعديلات، وتحديد المساهمات التي قام بها كل عضو في الفريق. من أبرز استخداماته:

1. استعراض السجل الأساسي

للحصول على السجل الأساسي لجميع الالتزامات في الفرع الحالي، يمكنك ببساطة استخدام الأمر:

git log

سيعرض هذا الأمر قائمة تحتوي على:

• معرّف الالتزام الكامل (40 حرفًا).
• اسم المؤلف.
• التاريخ.
• رسالة الالتزام.

2. عرض عدد محدد من الالتزامات

إذا كنت تريد استعراض عدد معين فقط من الالتزامات، يمكنك استخدام الخيار --n حيث يمثل n عدد الالتزامات المطلوبة. على سبيل المثال:

git log -3

سيعرض آخر ثلاثة التزامات فقط.

3. تخصيص التنسيق

يمكنك تخصيص مخرجات git log باستخدام الخيار --pretty. تتضمن الخيارات المتاحة:

• oneline: يعرض كل التزام في سطر واحد.
• short: يعرض ملخصًا مختصرًا لكل التزام.
• full: يعرض التفاصيل الكاملة لكل التزام.
• format:: يُتيح لك إنشاء تنسيق مخصص.

على سبيل المثال:

git log --pretty=oneline

4. تصفية الالتزامات

يمكنك تصفية الالتزامات حسب مجموعة من المعايير باستخدام خيارات مثل:

• --author: لتصفية الالتزامات بناءً على اسم المؤلف.
• --since و--until: لعرض الالتزامات التي أُجريت خلال فترة زمنية معينة.
• --grep: للبحث عن التزامات تحتوي على كلمات مفتاحية معينة في رسائل الالتزام.

مثال على تصفية الالتزامات بواسطة المؤلف:

git log --author="Ahmed"

5. عرض التعديلات بالتفصيل

لرؤية الملفات التي تغيرت والتعديلات التي أُجريت، يمكنك استخدام الخيار -p:

git log -p

سيعرض هذا الأمر التفاصيل الكاملة لكل تغيير أُجري في كل التزام.

أهم الخيارات مع git log

إليك قائمة ببعض الخيارات المفيدة مع git log:

الخيار	الوصف
--oneline	يعرض كل التزامات في سطر واحد.
--graph	يعرض رسمًا بيانيًا لتاريخ الالتزامات.
--stat	يعرض إحصائيات الملفات المعدلة.
--all	يعرض جميع الالتزامات في كافة الفروع.
--decorate	يعرض مراجع الالتزامات (Tags وBranches).

أمثلة عملية

فيما يلي بعض الأمثلة العملية التي تُظهر كيفية استخدام git log:

1. عرض جميع الالتزامات مع الرسم البياني

git log --oneline --graph --all

هذا الأمر يعرض جميع الالتزامات بطريقة مختصرة مع رسم بياني يُوضح العلاقة بين الفروع.

2. عرض الالتزامات مع التغييرات التفصيلية

git log -p --stat

يجمع هذا الأمر بين عرض التعديلات التفصيلية والإحصائيات لكل ملف.

3. البحث عن التزامات تحتوي على كلمة مفتاحية

git log --grep="bugfix"

يُظهر هذا الأمر جميع الالتزامات التي تحتوي على كلمة bugfix في رسالة الالتزام.

خاتمة

الأمر git log أداة قوية ومرنة تُتيح لك تحليل تاريخ المشروع بسهولة. باستخدام الخيارات المختلفة التي يُوفرها، يمكنك تخصيص طريقة عرض السجل لتناسب احتياجاتك الخاصة. سواء كنت تعمل بمفردك أو ضمن فريق، فإن فهم كيفية استخدام git log سيساعدك على إدارة مشاريعك بفعالية وتحقيق أقصى استفادة من نظام Git.