فصل 3 عملیات‌های گیت درس 14 از 16

آموزش گیت - عملیات Log

دستور git log به‌طور پیش‌فرض لاگ‌های کامیت را به ترتیب زمانی معکوس نمایش می‌دهد. این دستور مفید است؛ زیرا به ردیابی و درک تاریخچه یک پروژه، اینکه چه کسی تغییری ایجاد کرده و چه زمانی این کار را انجام داده، کمک می‌کند.

نحوه استفاده

۱. مشاهده تاریخچه کامیت‌ها − دستور git log لاگ‌های کامیت را به ترتیب زمانی معکوس نمایش می‌دهد؛ یعنی جدیدترین کامیت‌ها ابتدا فهرست می‌شوند.

هر ورودی کامیت شامل موارد زیر است:

  • یک شناسه یکتا برای کامیت به نام Commit hash.

  • نویسنده کامیت.

  • تاریخ و زمان کامیت.

  • پیام کامیت.

۲. فیلتر کردن کامیت‌ها − تاریخچه کامیت را می‌توان با استفاده از گزینه‌های مختلف فیلتر کرد؛ از جمله:

  • --author=<name> − فقط کامیت‌هایی که توسط نویسنده مشخص‌شده انجام شده‌اند، نمایش داده می‌شوند.

  • --since یا --until − کامیت‌هایی که قبل یا بعد از یک تاریخ خاص ثبت شده‌اند، نمایش داده می‌شوند.

۳. خروجی فشرده − معمولاً خروجی پیش‌فرض git log طولانی و پرجزئیات است، اما روش‌های مختلفی برای فشرده‌سازی آن وجود دارد.

  • --oneline − هر کامیت در یک خط همراه با هش کامیت و پیام کامیت نمایش داده می‌شود.

  • --graph − نمایش دقیق و گرافیکی تاریخچه کامیت‌ها را نشان می‌دهد. این گزینه برای تجسم شاخه‌ها و ادغام‌ها مفید است.

۴. نمایش تفاوت‌های کامیت − تفاوت‌ها (diffها) برای هر کامیت را می‌توان با استفاده از گزینه --patch / -p نیز مشاهده کرد.

۵. محدود کردن تعداد کامیت‌ها − تعداد کامیت‌ها را می‌توان با گزینه -n محدود کرد. برای مقدار n می‌توان یک عدد مشخص کرد.

۶. جستجوی کامیت‌ها بر اساس پیام − کامیت‌ها را می‌توان با گزینه --grep جستجو کرد. این گزینه به دنبال کامیت‌هایی می‌گردد که در پیام کامیت خود حاوی کلمات یا عبارت‌های خاصی باشند.

۷. مشاهده کامیت‌ها برای یک فایل خاص − تاریخچه کامیت برای یک فایل مشخص را نیز می‌توان مشاهده کرد. کافی است <file-path> را در انتهای دستور git log وارد کنید.

سینتکس

دستور git log دارای سینتکس زیر است:

git log

این دستور کامیت‌هایی را نمایش می‌دهد که از طریق پیوندهای والد از کامیت‌های داده‌شده قابل دسترسی باشند، اما نه کامیت‌هایی که پیشوند آن‌ها نماد ^ باشد.

git log feature-branch master ^bugfix-branch

این دستور به معنای فهرست کردن تمام کامیت‌هایی است که از feature-branch یا master قابل دسترسی هستند، اما از bugfix-branch خیر.

با حذف هر کامیتی که از bugfix-branch قابل دسترسی باشد، عملاً کامیت‌هایی نمایش داده می‌شوند که مختص feature-branch و master هستند.

در زبان Git، عبارت <commit1>..<commit2> میان‌بری برای ^<commit1> <commit2> است.

این یعنی کامیت‌هایی که از طریق <commit2> قابل دسترسی باشند اما از طریق <commit1> نه، در فهرست قرار می‌گیرند.

برای مثال، این دستورها معادل و قابل جایگزینی با یکدیگر هستند:

git log feature-branch..master

git log master ^feature-branch

فهرست کردن کامیت‌های قابل دسترسی از master اما نه از feature-branch، معنای واقعی هر دو دستور است.

Git تفاضل متقارن بین دو مجموعه از کامیت‌ها را محاسبه می‌کند؛ بنابراین این قالب <commit1>..<commit2> به‌ویژه برای ادغام‌ها کاربرد دارد.

استفاده از این نماد شبیه به به‌کارگیری یک عمل تفاضل مجموعه‌ای مستقیم‌تر است.

برای نمونه، می‌توان از آن برای شناسایی تفاوت‌های بین دو شاخه واگرا استفاده کرد.

git log branch1 branch2 --not $(git merge-base --all branch1 branch2)
git log branch1...branch2

تفاضل متقارن بین کامیت‌های قابل دسترسی از شاخه‌های ۱ و ۲، خروجی هر دو دستور است.

این دستور با استفاده از پارامترهای دستورهای git-rev-list و git-diff، امکان استفاده از گزینه‌هایی را فراهم می‌کند که موارد نمایش‌داده‌شده و نحوه نمایش تغییرات ایجادشده توسط هر کامیت را تغییر می‌دهند.

گزینه‌ها

گزینه‌های زیر در git log در دسترس هستند:

گزینه‌های قالب‌بندی

گزینه‌های زیر نحوه نمایش لاگ کامیت را کنترل می‌کنند:

۱. --oneline − هر کامیت در یک خط نمایش داده می‌شود که شامل هش کامیت و پیام آن است.

git log --oneline

۲. --pretty=<format> − می‌توان قالب خروجی را انتخاب کرد که می‌تواند شامل oneline، short، medium، full، fuller و format:<custom> باشد.

برای قالب سفارشی،占位‌نگهدارهایی وجود دارد که به شرح زیر هستند:

  • %H − هش کامیت

  • %h − هش کوتاه‌شده کامیت

  • %an − نام نویسنده

  • %ae − ایمیل نویسنده

  • %ar − تاریخ نویسنده، به‌صورت نسبی

  • %s − پیام کامیت

git log --pretty=short
git log --pretty=format:"%h - %an, %ar : %s"

۳. --graph − یک نمودار ASCII از تاریخچه شاخه‌ها و ادغام‌ها قابل مشاهده است.

git log --graph

۴. --decorate[=short|full|auto|no] − با استفاده از این گزینه، نام مراجع (references) در کنار هش کامیت‌ها دیده می‌شوند.

این گزینه بر اساس خروجی ترمینال به‌طور پیش‌فرض روی auto قرار دارد و تعیین می‌کند که نام مرجع‌هایی مانند refs/heads/، refs/tags/ و refs/remotes/ چگونه در کنار اطلاعات کامیت نمایش داده شوند.

git log --decorate

۵. --no-decorate − با استفاده از این گزینه، نام مراجع در کنار هش کامیت‌ها نمایش داده نمی‌شوند.

git log --no-decorate

۶. --stat − خلاصه تغییرات ایجادشده توسط هر کامیت.

git log --stat

گزینه‌های فیلتر کردن

از گزینه‌های زیر می‌توان برای فیلتر کردن لاگ کامیت استفاده کرد:

۱. --author=<pattern> − فقط کامیت‌هایی که توسط نویسنده مشخص‌شده انجام شده‌اند، نمایش داده می‌شوند.

git log --author="John Doe"

۲. --grp=<pattern> − پیام‌های کامیت را برای یک الگوی خاص جستجو می‌کند.

git log --grep="fixed"

۳. --since=<date> و --until=<date> − کامیت‌هایی که جدیدتر یا قدیمی‌تر از تاریخ مشخص‌شده باشند، قابل نمایش هستند.

git log --since="2015-01-01" --until="2015-01-02"

۴. --after=<date> و --before=<date> − مشابه مورد قبلی است، اما سینتکس آن متفاوت به‌کار می‌رود.

git log --after="2015-01-01" --before="2015-01-05"

۵. --all − تاریخچه کامیت همه شاخه‌ها قابل مشاهده است.

git log --all

گزینه‌های محدودسازی

از گزینه‌های زیر می‌توان برای محدود کردن لاگ کامیت استفاده کرد:

۱. -n <n> − تعداد کامیت‌ها را می‌توان با گزینه -n محدود کرد. برای مقدار n می‌توان یک عدد مشخص کرد.

git log -n=5

۲. -p − تفاوت‌ها (diffها) برای هر کامیت را نیز می‌توان با گزینه --patch / -p مشاهده کرد.

git log -p

۳. --max-count=<number> − این نیز روش دیگری برای محدود کردن تعداد کامیت‌ها است.

git log --max-count=5

۴. --skip=<number> − تعداد مشخص‌شده‌ای از کامیت‌ها را رد می‌کند.

git log --skip=5

۵. --reverse − ترتیب کامیت‌ها را معکوس می‌کند.

git log --reverse

گزینه‌های متفرقه

برخی دیگر از گزینه‌های متفرقه به شرح زیر هستند:

۱. --follow − حتی اگر نام یک فایل تغییر کند، گزینه --follow در git log تاریخچه آن را دنبال می‌کند، اما تنها برای دنبال کردن یک فایل منفرد مفید است.

git log --follow

۲. --decorate-refs=<pattern> − مراجع را با تطبیق آن‌ها با الگوی داده‌شده، تزئین/برچسب‌گذاری (decorate) می‌کند.

git log --decorate-refs="refs/heads/*"

۳. --decorate-refs-exclude=<pattern> − مراجع را با تطبیق آن‌ها با الگوی داده‌شده، مستثنی می‌کند.

git log --decorate-refs-exclude="refs/heads/*"

۴. --name-only − فقط نام فایل‌هایی را که در هر کامیت تغییر کرده‌اند، نمایش می‌دهد.

git log --name-only

۵. --name-status − فقط وضعیت فایل‌هایی را که در هر کامیت تغییر کرده‌اند، مانند اضافه‌شده، تغییریافته یا حذف‌شده، نمایش می‌دهد.

git log --name-status

۶. -S<string> − به دنبال کامیت‌هایی می‌گردد که در آن‌ها رشته داده‌شده یا اضافه شده و یا حذف شده باشد.

git log -S"fixed"

۷. --clear-decorations − گزینه --clear-decorations در دستور log در Git، نمایش مراجع را به‌طور پیش‌فرض به همه مراجع گسترش می‌دهد و هرگونه تنظیم قبلی --decorate-refs یا --decorate-refs-exclude را بازنشانی می‌کند.

git log --clear-decorations

۸. --source − نام مرجع استفاده‌شده در خط فرمان برای رسیدن به هر کامیت، توسط گزینه --source در دستور git log چاپ می‌شود.

git log --source

ترکیب گزینه‌ها

گزینه‌های ذکرشده در بالا را می‌توان با دستور git log ترکیب کرد؛ مانند git log --all --name-only، git log --oneline --max-count=5 و غیره.

گزینه‌های ارائه‌شده در بالا به شما امکان می‌دهند git log را متناسب با نیازهای خاص خود سفارشی کنید؛ چه در حال جستجوی تغییرات خاص باشید، چه در حال تحلیل تاریخچه یک شاخه و یا در حال ردیابی مشکلات و رفع آن‌ها.

پیشرفت مطالعه: وضعیت خوانده‌شدن این درس فقط در همین مرورگر ذخیره می‌شود؛ بدون نیاز به حساب کاربری.