قراءة سجل المشروع: أوامر log و diff و show والتنقل في السجل

سجل الإيداعات بوصفه دفتر يوميات للمشروع

• يعرض git log السجل مثل دفتر يوميات مقلوب
• كل إدخال هو لقطة للتغييرات
• يحتفظ بمعلومات عن من غيّر ومتى وماذا غيّر
• يتيح رؤية تطوّر الكود

تخيّل أن كل مرة تحفظ فيها التغييرات في Git، فإنك تضيف تدوينة إلى دفتر يوميات التطوير. أمر git log يعرض هذه التدوينات بترتيب زمني عكسي، من الأحدث إلى الأقدم. في هذا الدفتر يوجد التسلسل الزمني الكامل للمشروع: من أجرى كل تعديل، ومتى، وما هي التعديلات تحديدًا. هذا ليس مجرد قائمة تغييرات، بل تاريخ حي لتطوّر الكود. إن القدرة على قراءة هذا السجل وتحليله مهارة أساسية للعمل ضمن فريق؛ فمن خلال سجل الإيداعات ترى كيف نما المشروع، وما القرارات التي اتُخذت، ولماذا. لنلقِ نظرة أعمق على بنية الإيداع الواحد.

قراءة تدوينة الإيداع: الهاش، المؤلف، التاريخ

• الإيداع (commit): معرّف هاش فريد
• Author: الشخص الذي أجرى التغيير
• Date: متى أُجري التغيير
• الرسالة: ما الذي تغيّر بالضبط

انظر إلى ناتج أمر git log. تبدأ كل تدوينة بسلسلة طويلة من الأحرف؛ هذا هو هاش الإيداع، أي المعرّف الفريد له. بعده مباشرة ترى اسم مؤلف التغيير وتاريخ إدخاله. أسفل ذلك توجد رسالة الإيداع التي كتبها المطور عند حفظ التغييرات. انتبه إلى التنسيق: تظهر أولًا الرسالة البريدية للمؤلف بين علامتي < و >، ثم الطابع الزمني. تساعد هذه البيانات على فهم سياق التغيير، وإذا لزم الأمر التواصل مع المؤلف لطلب توضيحات. الآن بعد أن عرفنا بنية الإيداع، دعونا نفهم المقصود بالهاش ولماذا نحتاج إليه.

#!/bin/bash
cd ~/projects/git-course/
git log -1 --pretty=format:'الإيداع: %H%nالمؤلف: %an <%ae>%nالتاريخ: %ad%n%n    %s'

معرّف الالتزام – مفتاحك إلى تاريخ المشروع

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

معرّف الالتزام ليس مجرد مجموعة عشوائية من الأحرف، بل هو ناتج دالة تشفيرية تحوّل محتوى الالتزام إلى سلسلة فريدة. إذا غيرت حتى بايتًا واحدًا في الالتزام، سيتغيّر المعرّف بالكامل. هذا يضمن سلامة سجل التغييرات. بمعرفة المعرّف، يمكنك الرجوع إلى أي نسخة من الشيفرة كما لو أنك تضع إشارة مرجعية في كتاب. على سبيل المثال، أمر «git checkout» مع المعرّف سينقلك إلى حالة المشروع في لحظة هذا الالتزام. هذا مفيد جدًا عندما تحتاج إلى التراجع عن تغييرات أو تحليل الوقت الذي ظهرت فيه مشكلة معينة. الآن بعد أن فهمنا بنية السجل، دعونا نتعلم كيفية تصفيته—ففي المشاريع الحقيقية قد يكون هناك آلاف الالتزامات.