صار في موقعك الشخصي بضعة commits الآن. بعد ستة أشهر سيصبح فيه المئات، والسؤال الذي ستطرحه فعلًا لن يكون «ما هو السجلّ؟» بل شيئًا أدقّ: متى تعطّل الـ footer، وكيف كان هذا الملف قبل إعادة التصميم، وأيّ commit أضاف ذلك اللون. قراءة السجلّ جيدًا هي ما يجعلك تجيب عن هذه الأسئلة في ثوانٍ.
\nالأمر git log وحده يطبع كل commit، الأحدث أولًا، مع المعرّفات الكاملة والتواريخ. إنه شامل ومُتعب. هذه هي الصيغة التي تستحق الحفظ:
git log --oneline --graph --all* e5d81c0 (HEAD -> main) Merge branch 'dark-mode'\n|\\\n| * d4a7f20 (dark-mode) Add dark mode colors\n* | c39be11 Add projects page\n|/\n* b2e04f3 Add navigation bar with base styles\n* a1c9d72 Add home pageاقرأه من الأسفل إلى الأعلى لتتبع الترتيب الزمني. كل * هي commit، والخطوط تبيّن أيّ commit جاء من أيّ commit. وبين الأقواس أسماء دالّة (labels): main و dark-mode فرعان، و HEAD -> main تعني أنك على main. الخيار --all مهم: دونه يعرض Git فقط الـ commits التي يمكن الوصول إليها من مكانك، ولن يبقى خط dark-mode ظاهرًا إلا لأنه دُمج.
الناتج الطويل يُفتح في أداة تصفّح (pager). استخدم الأسهم أو المسافة للتمرير و q للخروج.
مرشّحات مفيدة يمكن جمعها كلها: -n 5 (آخر خمسة)، و --stat (أيّ الملفات تغيّرت)، و -p (الـ diffs كاملة)، و --author="Maya"، و --since="2 weeks ago"، و -- index.html (فقط الـ commits التي لمست ذلك الملف).
الناتج أعلاه تمثيل لـ رسم بياني موجَّه غير دوري (directed acyclic graph)، أو DAG. موجَّه لأن كل commit يشير إلى أبيه. وغير دوري لأنك لا تستطيع تتبّع الآباء والعودة إلى حيث بدأت؛ فلا يمكن لـ commit أن يكون جدًّا لنفسه. معظم الـ commits لها أب واحد. الـ root commit لا أب له. والـ merge commit له أبوان.
\nاحتفظ بهذه الصورة في ذهنك. في القسم الثاني سترى أن الـ branch ليس أكثر من واحد من هذه الأسماء الدالّة، وأن كل أمر متعلّق بالفروع إما يحرّك اسمًا أو يضيف دائرة.
\nتستطيع تسمية أي commit بمعرّفه، ويقبل Git أقصر بادئة لا لبس فيها، وهي عادةً 7 أحرف. المعرّفات hashes مشتقّة من محتوى الـ commit وبياناته الوصفية وأبيه، لذا لا تتغيّر أبدًا، ولا يشترك commitان مختلفان في المعرّف نفسه عمليًا.
\nغالبًا ما يكون العدّ انطلاقًا من مكانك أسهل:
\nHEAD هو الـ commit الذي أنت عليه.HEAD~1 (أو HEAD~) هو أبوه، و HEAD~3 هو ثلاثة أجيال إلى الخلف، مع تتبّع الأب الأول في كل مرة.HEAD^2 هو الأب الثاني لـ merge commit؛ وفي e5d81c0 أعلاه هو d4a7f20.dark-mode~1 هو b2e04f3.git show c39be11 # message, author, date and the diff it introduced\ngit show HEAD~2:styles.css # the whole file as it was in that snapshot\ngit diff a1c9d72 HEAD # everything that changed between two snapshots\ngit diff HEAD~3 HEAD -- styles.css # the same, for one file onlyيقبل git diff أي commitين لأن كلًا منهما لقطة كاملة. ويُحسب الـ diff عند الطلب بمقارنتهما. وكذلك الحال مع الـ diff الذي يطبعه git show: إنه لقطة هذا الـ commit مقارنةً بلقطة أبيه.
هكذا تتكامل هذه الأوامر. يخبرك صديق أن الـ footer في صفحة مشاريعك اختفى، وأنت متأكّد أنه كان موجودًا الأسبوع الماضي. ابدأ بتضييق السجلّ إلى الملف المعنيّ:
\ngit log --oneline --since=\"1 week ago\" -- projects.html8f1e2aa Move project cards into a grid\nc39be11 Add projects pageمشتبهان اثنان. انظر إلى الأحدث بالكامل:
\ngit show 8f1e2aa -- projects.htmlيُظهر الـ diff كتلة <footer> باللون الأحمر، أُزيلت مع ترميز القائمة القديمة. هذا هو الجاني، وجدته في أقل من دقيقة. ولتأخذ ترميز الـ footer القديم دون إرجاع أي شيء، اطبع الملف كما كان في الـ commit الأب وانسخ ما تحتاجه:
git show 8f1e2aa~1:projects.htmlلم يغيّر هذا التحقيق ملفًا واحدًا ولا commitًا واحدًا. قراءة السجلّ آمنة دائمًا، فافعلها بحرية وكثيرًا. معظم «حالات الطوارئ في Git» التي رأيتها كانت في الحقيقة مشكلات قراءة: شخص ما ذُعر قبل أن ينظر إلى الرسم، والجواب كان موجودًا في git log منذ البداية.
رأيت أسماء مثل main و dark-mode معلّقة على الـ commits. يبدأ القسم الثاني بشرح حقيقة هذه الأسماء، ولماذا يكاد إنشاء واحد منها لا يكلّف شيئًا.
git log --oneline --graph --all يرسم الرسم البياني في الطرفية، بما فيها الفروع التي لست عليها.","git show <commit> يطبع رسالة commit واحد وتغييراته؛ و git show <commit>:<path> يطبع ملفًا كما كان حينها.","HEAD~1 هو الـ commit الذي يسبق الـ commit الذي أنت عليه، و HEAD~3 ثلاث خطوات إلى الخلف عبر الآباء الأوائل.","git diff A B يقارن أي لقطتين، و -- <path> يحصر المقارنة في ملف واحد."],"further":[{"title":"Viewing the Commit History (Pro Git)","url":"https://git-scm.com/book/en/v2/Git-Basics-Viewing-the-Commit-History"},{"title":"git log reference","url":"https://git-scm.com/docs/git-log"},{"title":"gitrevisions (naming commits)","url":"https://git-scm.com/docs/gitrevisions"}],"quiz":[{"q":"الأمر git log على main لا يعرض commit أنشأته على فرعك dark-mode. لماذا؟
dark-mode."},{"text":"git log لا يعرض إلا الـ commits التي يمكن الوصول إليها من الـ HEAD عبر تتبّع الآباء، وهذا الـ commit ليس منها.","why":"صحيح. main لا يقود إليه. الأمر git log --all أو git log dark-mode سيعرضه."},{"text":"git log يخفي الـ commits إلى أن يتم رفعها.","why":"لا يهتمّ Git بالرفع حين يعرض السجلّ المحلي. الـ commits غير المرفوعة تظهر كغيرها تمامًا."},{"text":"تحتاج إلى git log -p لرؤية commits الفروع الأخرى.","why":"-p يضيف الـ diff الخاص بكل commit إلى الناتج. ولا يغيّر الـ commits التي تُعرض."}],"answer":1},{"q":"تريد رؤية styles.css كما كان تمامًا قبل commitين، دون تغيير أي ملف. أيّ أمر يفعل ذلك؟
git restore styles.css~2","why":"~2 تنطبق على الـ commits لا على أسماء الملفات، و git restore يكتب في الـ working tree، وهذا ما لا تريده."},{"text":"git log -2 styles.css","why":"هذا يسرد آخر commitين لمسا الملف. يعرض الرسائل، لا محتوى الملف."},{"text":"git diff HEAD~2","why":"هذا يعرض التغييرات بين ذلك الـ commit والـ working tree، لا المحتوى الكامل للملف."},{"text":"git show HEAD~2:styles.css","why":"صحيح. الصيغة <commit>:<path> تسمّي ملفًا داخل لقطة، و git show يطبعه دون أن يلمس ملفاتك."}],"answer":3},{"q":"كم أبًا للـ merge commit الذي يدمج dark-mode في main؟
main والـ commit الذي كان عليه dark-mode.","why":"صحيح. وجود أبوين هو ما يجعله merge، ولهذا تلتقي الخطوط في الرسم عند تلك النقطة."},{"text":"واحد، الـ commit الذي كان عليه main قبل الدمج.","why":"الأب الواحد صفة الـ commit العادي. أما الـ merge فيسجّل السجلّين اللذين يجمعهما."},{"text":"لا أب له، لأن الـ merge commit يبدأ سجلًّا جديدًا.","why":"الـ commit الأول في الـ repository وحده (الـ root commit) لا أب له."}],"answer":0},{"q":"أيّ أمر يسرد فقط الـ commits التي أضافت تغييراتها النص dark-mode أو أزالته؟
git log --grep dark-mode","why":"--grep يبحث في رسائل الـ commits، لا في تغييرات الكود داخلها."},{"text":"git diff dark-mode","why":"هذا يقارن الـ working tree بفرع dark-mode. ولا يسرد أي commits."},{"text":"git log -S dark-mode","why":"صحيح. خيار البحث (pickaxe) -S يجد الـ commits التي غيّرت عدد مرات ظهور النص، وهكذا تتعقّب متى أُضيف شيء أو أُزيل."},{"text":"git show dark-mode","why":"هذا يعرض الـ commit الذي يشير إليه فرع dark-mode، إن وُجد فرع بهذا الاسم."}],"answer":2}],"exercise":{"kind":"choice","multiple":false,"options":["a","b","c","d"],"correct":["c"],"title":"اقرأ الرسم البياني","prompt":"هذا سجلّ الموقع الشخصي مرسومًا كرسم بياني للـ commits، وهو الشكل نفسه الذي يرسمه git log --oneline --graph --all نصًّا في الطرفية. الأسهم تتّجه من كل commit إلى أبيه.
:::figure رسم الـ commits في الموقع الشخصي\n
\nأنت على main. ما الـ commits التي يسردها git log --oneline hero؟
git log <name> يبدأ من الـ commit الذي يشير إليه ذلك الاسم.","من هناك يتتبّع أسهم الآباء فقط. ولا يمشي أبدًا إلى الأمام نحو الأبناء.","ابدأ من الـ commit الذي يحمل الاسم hero وتتبّع الأسهم حتى تنتهي."],"explanation":"git log hero يبدأ من 7a8b، الـ commit الذي يشير إليه فرع hero، ويتتبّع الآباء: 7a8b ← 3c4d ← 1a2b. الـ merge commit ذو المعرّف 9c0d ابن لـ 7a8b، و Git لا يمشي أبدًا من الأب إلى الابن، فلا يظهر في القائمة. و 5e6f على الجهة الأخرى من التفرّع، وليس من أسلاف hero أيضًا.
hero دُمج في main.","why":"الدمج جعل commits الفرع hero قابلة للوصول من main، لا العكس. و git log hero يبدأ من hero ويمشي إلى الخلف فقط."},"b":{"text":"7a8b فقط، الـ commit الذي يشير إليه hero.","why":"git log يسرد الـ commit الذي يبدأ منه وكل أسلافه، لا commitًا واحدًا. أما git show hero فسيطبع 7a8b وحده."},"c":{"text":"7a8b و 3c4d و 1a2b.","why":"صحيح. ابدأ من 7a8b وتتبّع الآباء: 3c4d، ثم الـ root commit ذو المعرّف 1a2b."},"d":{"text":"9c0d و 7a8b و 3c4d و 1a2b.","why":"9c0d ابن لـ 7a8b. والـ commits لا تعرف أبناءها، لذا لا يستطيع git log الوصول إليه انطلاقًا من hero."}}},"words":675,"readMinutes":4}