آموزش گیت - تاریخچه کامیت‌ها

گیت این قابلیت را دارد که تاریخچه دقیقی از تغییرات پروژه شما را در طول زمان نگه دارد. گیت با ثبت هر تغییر در یک کامیت، به توسعه‌دهندگان امکان می‌دهد تکامل کدبیس خود را ردیابی، بازگردانی و درک کنند.

تاریخچه کامیت‌ها یک منبع کلیدی هم برای توسعه‌دهندگان مستقل و هم برای تیم‌هایی است که روی یک پروژه کار می‌کنند؛ زیرا به آن‌ها کمک می‌کند تغییرات گذشته را بررسی کنند، مشکلات را اشکال‌زدایی نمایند و به‌صورت مؤثر همکاری داشته باشند.

اهمیت تاریخچه کامیت‌ها

تاریخچه کامیت در گیت اساساً یک خط زمانی از اسنپ‌شات‌ها است که هر کدام نشان‌دهنده یک نقطه از روند توسعه پروژه هستند. با مشاهده تاریخچه کامیت‌ها می‌توانید:

  • تکامل پروژه خود را درک کنید: ببینید کدبیس شما در طول زمان چگونه تغییر کرده و چه کسی این تغییرات را ایجاد کرده است.

  • باگ‌ها را ردیابی کنید: با بررسی کامیت‌های خاص، متوجه شوید که یک باگ چه زمانی و در کجا وارد کد شده است.

  • به حالت‌های قبلی بازگردید: اگر یک تغییر اخیر مشکلی ایجاد کند، می‌توانید به یک نسخه پایدار و قدیمی‌تر از کد برگردید.

  • به‌صورت کارآمد همکاری کنید: تیم‌ها می‌توانند ببینند دیگران روی چه چیزی کار می‌کنند، تغییرات کد را بازبینی کنند و مطمئن شوند پروژه در مسیر درست پیش می‌رود.

دستور `git log`

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

دستور git log فهرستی از کامیت‌ها را از آخرین کامیت به ترتیب نمایش می‌دهد، همراه با اطلاعاتی مانند هش کامیت، نویسنده، تاریخ و پیام کامیت.

برای مشاهده تاریخچه کامیت‌ها در گیت، دستور زیر را اجرا کنید:

$ git log
$ git log
commit 94744071e847ab78390eb1b8a5e013dbeee7ced2 (HEAD -> main, origin/main, origin/HEAD)
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 17:51:17 2024 +0530

   modified the margin and font size

commit 1bc52022c8fe3ee799ccf36bdc3e6ec0c99bb9f5
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 13:01:47 2024 +0530

   changed the width dimension

commit a98962782a8bc6ac91b793b634eb5786b3fb85fc
Author: tonystark <86562149+tonystark@users.noreply.github.com>
Date:   Sat Dec 10 08:35:10 2022 +0000

   Initial commit
:...skipping...

این نمای ساده لاگ، یک تاریخچه خطی از کامیت‌ها به شما می‌دهد که جدیدترین تغییرات در بالای آن قرار می‌گیرند.

دستور git log> نمای پیش‌فرض تاریخچه کامیت را نمایش می‌دهد که شامل موارد زیر است:

  • هش کامیت: یک شناسه یکتا (هش SHA-1) برای کامیت.

  • نویسنده: نام و نشانی ایمیل شخصی که کامیت را ثبت کرده است.

  • تاریخ: تاریخ و زمانی که کامیت ثبت شده است.

  • پیام کامیت: توضیح کوتاهی که نویسنده ارائه می‌دهد تا مشخص شود کامیت شامل چه مواردی است.

دستور git log روش‌های مختلفی برای مشاهده تاریخچه مخزن شما نشان می‌دهد.

مرور تاریخچه کامیت‌ها بر اساس فایل

گاهی ممکن است بخواهید تاریخچه یک فایل خاص را به‌جای کل پروژه مشاهده کنید. گیت این امکان را با دستور git log و نام فایل فراهم می‌کند:

git log <file>

اگر می‌خواهید diff مربوط به هر کامیتی را که روی فایل اثر گذاشته ببینید، می‌توانید پرچم -p را اضافه کنید:

$ git log -p -2

در دستور بالا، گزینه -p نمای دقیقی از کامیت نمایش می‌دهد و -2 دو کامیت آخر را نشان می‌دهد.

$ git log -p -2
commit 45ef43e5c3664f9ff725ad7b41a80af6ab515 (HEAD -> main, origin/main, origin/HEAD)
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 17:51:17 2024 +0530

   changed top and right dimensions

diff --git a/main.html b/main.html
index f7f85dd..9b97bad 100644
--- a/main.html
+++ b/main.html
@@ -46,8 +46,8 @@
            display : inline-block;
            border  : 2px solid green;
            position: absolute;
-           right:45px;
            top: 36px;
+           right:42px; ^M
+           top:35px; ^M
:...skipping...
commit 45ef43e5c3664f9ff725ad7b41a80af6ab515 (Head -> main, origin/main, origin/HEAD)
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 18:56:17 2024 +0530

   changed top and right dimensions

diff --git a/main.html b/main.html
index f7f85dd..9b97bad 100644
--- a/main.html
+++ b/main.html
@@ -46,8 +46,8 @@

می‌توانید از دستور git log --stat برای نمایش یک نمای مختصر از تغییرات انجام‌شده در هر کامیت استفاده کنید؛ از جمله تعداد فایل‌های تغییریافته، تعداد خطوط اضافه‌شده یا حذف‌شده و نام فایل.

$ git log --stat
$ git log --stat
commit 45ef43e5c3664f9ff725ad7b41a80af6ab515 (HEAD -> main, origin/main, origin/HEAD)
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 17:51:17 2024 +0530

   changed top and right dimensions

main.html  |  4 ++--
1 file changed, 2 insertions(+), 2 deletion(-)

commit 94744071e847ab78390eb1b8a5e013dbeee7ced2
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 17:51:17 2024 +0530

   modified the margin and font size

main.html  |  4 ++--
1 file changed, 2 insertions(+), 2 deletion(-)

commit 1bc52022c8fe3ee799ccf36bdc3e6ec0c99bb9f5
Author: Tutorialspoint <tutorialspoint@example.com>
:...skipping...
commit 45ef43e5c3664f9ff725ad7b41a80af6ab515 (Head -> main, origin/main, origin/HEAD)
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 13:01:47 2024 +0530

   changed top and right dimensions

اگر نمای کاملی از تمام تغییرات انجام‌شده در هر کامیت می‌خواهید، شامل اینکه دقیقاً کدام خطوط اضافه، حذف یا اصلاح شده‌اند.

$ git log --stat -p
$ git log --stat -p
commit 45ef43e5c3664f9ff725ad7b41a80af6ab515 (HEAD -> main, origin/main, origin/HEAD)
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 17:51:17 2024 +0530

   changed top and right dimensions
---
main.html  |  4 ++--
1 file changed, 2 insertions(+), 2 deletion(-)

diff --git a/main.html b/main.html
index f7f85dd..9b97bad 100644
--- a/main.html
+++ b/main.html
@@ -46,8 +46,8 @@
            display : inline-block;
            border  : 2px solid green;
            position: absolute;
:...skipping...
commit 45ef43e5c3664f9ff725ad7b41a80af6ab515 (Head -> main, origin/main, origin/HEAD)
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 18:56:17 2024 +0530

سفارشی‌سازی خروجی `git log`

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

لاگ تک‌خطی

اگر نمای فشرده‌تری از تاریخچه کامیت‌ها می‌خواهید که هر کامیت را در یک خط نشان دهد، می‌توانید از پرچم --oneline استفاده کنید. این گزینه به‌ویژه برای گرفتن یک نمای کلی و سریع از تاریخچه مفید است.

$ git log --oneline

نمونه خروجی:

abc1234 Add user authentication feature
def7890 Update README with installation instructions

این نما فقط هش کوتاه‌شده کامیت و پیام کامیت را نمایش می‌دهد و مرور سریع تاریخچه را آسان می‌کند.

فیلتر کردن بر اساس تاریخ یا نویسنده

می‌توانید تاریخچه کامیت‌ها را بر اساس تاریخ، نویسنده یا ترکیبی از هر دو فیلتر کنید. این کار زمانی مفید است که می‌خواهید یک کامیت خاص را پیدا کنید یا تغییرات انجام‌شده در یک بازه زمانی مشخص را بررسی نمایید.

فیلتر بر اساس تاریخ: برای نمایش کامیت‌های ثبت‌شده از یک تاریخ مشخص به بعد، از گزینه --since استفاده کنید:

git log --since="2024-08-01"

فیلتر بر اساس نویسنده: برای مشاهده کامیت‌های ثبت‌شده توسط یک نویسنده مشخص، از گزینه --author استفاده کنید:

git log --author="Tutorialspoint "

می‌توانید این گزینه‌ها را ترکیب کنید تا تاریخچه را بیشتر محدود نمایید. برای مثال، برای مشاهده همه کامیت‌های ثبت‌شده توسط Tutorialspoint از ۱ اوت ۲۰۲۴ به بعد:

git log --author="Tutorialspoint" --since="2024-08-01"

قالب‌بندی خروجی کامیت

گیت به شما امکان می‌دهد نحوه نمایش هر کامیت را با استفاده از گزینه --pretty سفارشی کنید. می‌توانید یک قالب مشخص کنید یا از یکی از قالب‌های ازپیش‌تعریف‌شده گیت استفاده نمایید.

قالب کوتاه:

git log --pretty=short

قالب سفارشی: می‌توانید مشخص کنید که کدام عناصر کامیت را می‌خواهید ببینید:

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

دستور git log --pretty=format:"%h - %an, %ar : %s" برای نمایش اطلاعات خاصی درباره هر کامیت به شکلی ساده به کار می‌رود. این دستور هر کامیت را در یک خط همراه با هش کوتاه‌شده کامیت، نویسنده، تاریخ و پیام کامیت نشان می‌دهد.

>

  • %h: هش کامیت

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

  • %ar: تاریخ

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

$ git log --pretty=format:"%h - %an, %ar : %s"
$ git log --pretty=format:"%h - %an, %ar : %s"
09708ca - Tutorialspoint, 15 minutes ago : color and heading changed
45ef43e - Tutorialspoint, 18 hours ago : changed top and right dimensions
9474407 - Tutorialspoint, 19 hours ago : modified the margin and font size
1bc5202 - Tutorialspoint, 23 hours ago : changed the width dimension
a989627 - tonystark, 1 year, 5 months ago : Initial commit

جدول زیر مشخص‌کننده‌های مفیدی را نمایش می‌دهد که می‌توان همراه با دستور git log --pretty=format استفاده کرد.

مشخص‌کننده توضیح خروجی
%H هش کامیت
%h هش کوتاه‌شده کامیت
%T هش درخت (Tree)
%t هش کوتاه‌شده درخت (Tree)
%P هش‌های والد
%p هش‌های کوتاه‌شده والد
%an نام نویسنده
%ae ایمیل نویسنده
%ad تاریخ نویسنده
%ar تاریخ نسبی نویسنده
%cn نام ثبت‌کننده کامیت (Committer)
%ce ایمیل ثبت‌کننده کامیت (Committer)
%cd تاریخ ثبت‌کننده کامیت (Committer)
%cr تاریخ نسبی ثبت‌کننده کامیت (Committer)
%s موضوع
  • وقتی گزینه‌های --oneline یا --format را با --graph ترکیب کنید، گیت یک نمودار ASCII در کنار هر عبارت کامیت نمایش می‌دهد.

  • دستور git log --pretty=format:"%h %s" --graph هش کوتاه‌شده و پیام کامیت را همراه با نمایش بصری از تاریخچه شاخه‌ها و ادغام‌ها نشان می‌دهد.

$ git log --pretty=format:"%h %s" --graph
$ git log --pretty=format:"%h %s" --graph
- 09708ca color and heading changed
- 45ef43e changed top and right dimensions
- 9474407 modified the margin and font size
- 1bc5202 changed the width dimension
- a989627 Initial commit
  • دستور git log --pretty=oneline برای گرفتن یک نمای کلی سریع یا کوتاه از تعداد زیادی کامیت بدون عبور از چندین خط داده برای هر کامیت استفاده می‌شود.

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

$ git log --pretty=oneline
$ git log --pretty=oneline
45ef43e5c3664f9ff725ad7b41a80af6ab515 (HEAD -> main, origin/main, origin/HEAD) changed top and right dimensions
94744071e847ab78390eb1b8a5e013dbeee7ced2 modified the margin and font size
1bc52022c8fe3ee799ccf36bdc3e6ec0c99bb9f5 changed the width dimension
a98962782a8bc6ac91b793b634eb5786b3fb85fc Initial commit

جدول زیر گزینه‌های رایج قالب‌بندی را برای git log نمایش می‌دهد:

گزینه‌ها توضیح خروجی
-p نمایش وصله (patch) ایجادشده در هر کامیت.
--stat نمایش آمار فایل‌های تغییریافته در هر کامیت.
--shortstat نمایش تنها خط مربوط به تغییرات/افزودن‌ها/حذف‌ها از دستور --stat.
--name-only نمایش فهرست فایل‌های تغییریافته پس از اطلاعات کامیت.
--name-status نمایش فهرست فایل‌های متأثر همراه با اطلاعات اضافه‌شده/تغییریافته/حذف‌شده نیز.
--abbrev-commit نمایش تنها چند کاراکتر اول چک‌سام SHA-1 به‌جای همه ۴۰ کاراکتر.
--relative-date نمایش تاریخ به شکل نسبی (برای مثال، 3 weeks ago) به‌جای استفاده از قالب کامل تاریخ.
--graph نمایش یک نمودار ASCII از تاریخچه شاخه‌ها و ادغام‌ها در کنار خروجی لاگ.
--pretty نمایش کامیت‌ها در یک قالب جایگزین. مقادیر گزینه شامل oneline، short، full، fuller و format (جایی که قالب دلخواه خود را مشخص می‌کنید) هستند.
--oneline شکل کوتاه‌شده ترکیب --pretty=oneline --abbrev-commit است که با هم استفاده می‌شوند.

محدود کردن خروجی لاگ

دستور git log چند گزینه محدودکننده مفید ارائه می‌دهد که به شما امکان می‌دهند تنها زیرمجموعه‌ای از کامیت‌ها را نمایش دهید. می‌توانید از -<n> برای نمایش n کامیت آخر استفاده کنید.

گیت به‌طور خودکار تمام خروجی را از طریق یک صفحه‌بند (pager) هدایت می‌کند تا در هر لحظه تنها یک صفحه از خروجی لاگ را ببینید.

می‌توانید تاریخچه کامیت‌های گیت را برای بازه‌های زمانی مشخص با استفاده از گزینه‌های محدودکننده زمانی مانند --since و --until مشاهده کنید.

دستور زیر تاریخچه کامیت‌ها را از ۳ هفته پیش تاکنون نمایش می‌دهد:

$ git log --since=3.weeks
commit 09708ca8bfee4ad20414511b2d847282b17b1c9f (Head -> main, origin/main, origin/HEAD)
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Thu Apr 18 12:15:17 2024 +0530

   color and heading changed

commit 45ef43e5c3664f9ff725ad7b41a80af6ab515
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 18:56:17 2024 +0530

   changed top and right dimensions

commit 94744071e847ab78390eb1b8a5e013dbeee7ced2
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 17:51:17 2024 +0530

   modified the margin and font size

commit 1bc52022c8fe3ee799ccf36bdc3e6ec0c99bb9f5
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 13:01:47 2024 +0530

دستور زیر تاریخچه کامیت‌ها را از 2022-03-17 به بعد نمایش می‌دهد:

$ git log --since=2022-03-
commit 09708ca8bfee4ad20414511b2d847282b17b1c9f (Head -> main, origin/main, origin/HEAD)
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Thu Apr 18 12:15:17 2024 +0530

   color and heading changed

commit 45ef43e5c3664f9ff725ad7b41a80af6ab515
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 18:56:17 2024 +0530

   changed top and right dimensions

commit 94744071e847ab78390eb1b8a5e013dbeee7ced2
Author: Tutorialspoint <tutorialspoint@example.com>
Date:   Wed Aug 07 17:51:17 2024 +0530

   modified the margin and font size

:...skipping...
commit 09708ca8bfee4ad20414511b2d847282b17b1c9f (Head -> main, origin/main, origin/HEAD)

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

نکته: می‌توانید از گزینه‌های --author و --grep چندین بار استفاده کنید تا کامیت‌ها را بر اساس معیارهای مختلف فیلتر نمایید. افزودن گزینه --all-match خروجی را به کامیت‌هایی محدود می‌کند که همه الگوهای --grep داده‌شده را برآورده کنند.

گزینه -S به عنوان «کلنگ معدنی (pickaxe)» گیت شناخته می‌شود. این گزینه کامیت‌هایی را نمایش می‌دهد که تعداد رخداد یک رشته مشخص را تغییر می‌دهند.

$ git log -S <string>
$ git log -S font-size
commit a98962782a8bc6ac91b793b634eb5786b3fb85fc
Author :tonystark <86562149+tonystark@users.noreply.github.com>
Date : Sat Dec 10 08:35:10 2022 +0000

   Initial commit
  
   Created from https://vercel.com/new

می‌توانید پس از git log -- نام یک پوشه یا فایل را مشخص کنید که خروجی لاگ را فیلتر می‌کند تا فقط کامیت‌هایی را نشان دهد که آن فایل‌ها را تغییر داده‌اند.

$ git log -- path/to/file
$ git log -- main.html
commit 09708ca8bfee4ad20414511b2d847282b17b1c9f (HEAD -> main, origin/main, origin/HEAD)
Author :Tutorialspoint <tutorialspoint@example.com>
Date : Thu Apr 18 12:15:17 2024 +0530

   color and heading changed

commit 45ef43e5c3664f9ff725ad7b41a80af6ab515
Author : Tutorialspoint <tutorialspoint@example.com>
Date :   Wed Aug 07 18:56:17 2024 +0530

   changed top and right dimensions

commit 94744071e847ab78390eb1b8a5e013dbeee7ced2
Author :Tutorialspoint <tutorialspoint@example.com>
Date : Wed Aug 07 17:51:17 2024 +0530

   modified the margin and font size

commit 1bc52022c8fe3ee799ccf36bdc3e6ec0c99bb9f5
Author :Tutorialspoint <tutorialspoint@example.com>
Date : Wed Aug 07 13:01:47 2024 +0530

جدول زیر گزینه‌هایی را برای محدود کردن خروجی git log نمایش می‌دهد:

گزینه‌ها توضیح خروجی
-<n> نمایش وصله (patch) ایجادشده در هر کامیت.
--since, --after محدود کردن کامیت‌ها به کامیت‌هایی که پس از تاریخ مشخص‌شده ثبت شده‌اند.
--until, --before محدود کردن کامیت‌ها به کامیت‌هایی که پیش از تاریخ مشخص‌شده ثبت شده‌اند.
--author نمایش تنها کامیت‌هایی که بخش نویسنده (author) آن‌ها با رشته مشخص‌شده مطابقت داشته باشد.
--committer نمایش تنها کامیت‌هایی که بخش ثبت‌کننده کامیت (committer) آن‌ها با رشته مشخص‌شده مطابقت داشته باشد.
--grep نمایش تنها کامیت‌هایی که پیام کامیت آن‌ها حاوی رشته باشد.
-S نمایش تنها کامیت‌هایی که کدی مطابق با رشته اضافه یا حذف می‌کنند.

برای یافتن کامیت‌هایی که فایل‌های تست را در کد منبع گیت تغییر داده‌اند و توسط Tutorialspoint در ماه آوریل ۲۰۲۴ ثبت شده‌اند، دستور زیر را اجرا کنید:

$ git log --pretty="%h - %s" --author='Tutorialspoint' --since="2024-4-1" --before="2024-4-30"
09708ca - color and heading changed
45ef43e - changed top and right dimensions
9474407 - modified the margin and font size
1bc5202 - changed the width dimension

برای یافتن حجم کل تاریخچه کامیت‌ها، دستور زیر را اجرا کنید:

$ git log --log-size
commit 09708ca8bfee4ad20414511b2d847282b17b1c9f (HEAD -> main, origin/main, origin/HEAD)
log size: 122
Author :Tutorialspoint <tutorialspoint@example.com>
Date : Thu Apr 18 12:15:17 2024 +0530

   color and heading changed

commit 45ef43e5c3664f9ff725ad7b41a80af6ab515
log size: 130
Author :Tutorialspoint <tutorialspoint@example.com>
Date : Wed Aug 07 18:46:17 2024 +0530

   changed top and right dimensions

commit 94744071e847ab78390eb1b8a5e013dbeee7ced2
log size: 130
Author :Tutorialspoint <tutorialspoint@example.com>
Date : Wed Aug 07 17:51:17 2024 +0530

   modified the margin and font size

:...skipping...

برای یافتن تاریخچه کامیت‌ها به ترتیب معکوس، دستور زیر را اجرا کنید:

$ git log --reverse
commit a98962782a8bc6ac91b793b634eb5786b3fb85fc
Author: tonystark <86562149+tonystark@users.noreply.github.com>
Date: Sat Dec 10 08:35:10 2022 +0000

   Initial commit

   Created from https://vercel.com/

commit 1bc52022c8fe3ee799ccf36bdc3e6ec0c99bb9f5
Author: Tutorialspoint <tutorialspoint@example.com>
Date: Wed Aug 07 13:01:47 2024 +0530

   changed the width dimension

commit 94744071e847ab78390eb1b8a5e013dbeee7ced2
Author: Tutorialspoint 
Date: Wed Aug 07 17:51:17 2024 +0530

:...skipping...
commit a98962782a8bc6ac91b793b634eb5786b3fb85fc
Author :tonystark <86562149+tonystark@users.noreply.github.com>
Date : Sat Dec 10 08:35:10 2022 +0000

   Initial commit

   Created from https://vercel.com/new

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