git annotate

تتبّع الأخطاء

تعليق أسطر ملف بمعلومات الـ commit (صيغة blame القديمة)

يؤدي الأمر 'git annotate' عمل git blame نفسه — يوسم كل سطر في ملف بالـ commit الذي غيّره آخر مرة — لكنه يطبع الصيغة القديمة المفصولة بعلامات جدولة التي ما زالت بعض الأدوات تقرؤها. للاستخدام اليومي، الأمر الذي يستحق التعلّم هو git blame.

الصيغة

git annotate [<options>] [<rev>] <file>
[ ] اختياري| أو<arg> قيمة تُستبدل... قابل للتكرار--flag خيار

أمثلة

تعليق ملف

git annotate app.js

الـ commit والمؤلف والتاريخ ورقم السطر لكل سطر.

أمثلة على سير العمل

1
git annotate app.js > app.annotate

حفظ المخرجات للأداة

حل المشكلات

fatal: no such path 'x' in HEAD

السبب: الملف غير متتبَّع

تحقّق من المسار بـ git ls-files

نصائح وأخطاء شائعة

أفضل الممارسات

  • ✓استخدم git blame في السكربتات الجديدة وفي عملك اليومي.

أخطاء متكررة

  • ✗تعلّم annotate بدل blame: لدى blame خيارات أكثر وصيغة أوضح.

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

A:

لا، يُحتفظ به للتوافق، لكن git blame هو الأمر الموثَّق والأغنى.