git shortlog

الفحص والمقارنة

تلخيص السجل حسب المؤلف

يجمع الأمر 'git shortlog' الـ commits حسب المؤلف: كل مؤلف مع عدد commits‏ه وعناوينها. يُستخدم لملاحظات الإصدار وقوائم المساهمين. مع -s تُعرض الأعداد فقط، و-n يرتّب حسب عدد الـ commits، و-e يضيف البريد. في الطرفية يلخّص الفرع الحالي؛ وفي السكربتات سمِّ المراجعة (git shortlog HEAD).

الصيغة

git shortlog [<options>] [<revision-range>] [[--] <path>...]
[ ] اختياري| أو<arg> قيمة تُستبدل... قابل للتكرار--flag خيار

الخيارات

انقر على أي خيار لتوسيعه

مبتدئ (3)

عرض عدد الـ commits لكل مؤلف فقط.

موصى بهسطر لكل مؤلف مع عدد الـ commits

مثال

git shortlog -s

ترتيب المؤلفين حسب عدد الـ commits بدل الاسم.

موصى بهترتيب المؤلفين حسب عدد الـ commits

مثال

git shortlog -sn

عرض بريد كل مؤلف.

عند الحاجةالتمييز بين مؤلفين بالاسم نفسه

مثال

git shortlog -sne

اختيار الخيار المناسب

shortlog مقابل log

التجميع

الأمرمجمّع حسب
git log --onelineالوقت (الأحدث أولًا)
git shortlogالمؤلف

أمثلة

حسب المؤلف

git shortlog

كل مؤلف مع عناوين commits‏ه.

الترتيب

git shortlog -sn

أعداد الـ commits، الأنشط أولًا.

منذ إصدار

git shortlog v1.0..HEAD

من فعل ماذا منذ v1.0 — ملاحظات الإصدار.

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

1
git shortlog v1.0..v1.1

التغييرات مجمّعة حسب المؤلف

2
git shortlog -sn v1.0..v1.1

شكر المساهمين

حل المشكلات

لا مخرجات

السبب: ليس في طرفية، فيقرأ shortlog الدخل القياسي

أعطِ مراجعة: git shortlog HEAD

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

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

  • ✓احتفظ بملف .mailmap كي يُحسب كل شخص مرة واحدة.

أخطاء متكررة

  • ✗الحصول على مخرجات فارغة في سكربت: دون مراجعة يقرأ shortlog هناك من الدخل القياسي — مرّر HEAD.
  • ✗عدّ الشخص نفسه مرتين لأنه استخدم بريدين — أضف ملف .mailmap.

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

A:

نعم، ما لم تضف --no-merges.