Polecenie Git Log --Patch: Jak śledzić zmiany w repozytorium

Git to potężne narzędzie, które pomaga programistom śledzić zmiany w kodzie, zarządzać wersjami i współpracować z zespołem. Jednym z wielu przydatnych poleceń Git jest git log --patch, które pozwala na szczegółowe śledzenie zmian w repozytorium, pokazując, jakie dokładnie linie kodu zostały zmodyfikowane w poszczególnych commitach. W tym artykule przyjrzymy się, jak działa to polecenie i jak możesz wykorzystać je w swojej codziennej pracy.

Czym jest polecenie git log --patch?

Za pomocą polecenia git log --patch możesz uzyskać szczegółowy podgląd zmian wprowadzonych w Twoim repozytorium Git. Zamiast tylko listować historie commitów, jak w przypadku zwykłego polecenia git log, git log --patch pokazuje również różnice (diff) między wersjami plików dla każdego commita. To świetne narzędzie, jeśli chcesz szybko sprawdzić, jakie zmiany zostały wprowadzone w kodzie i jak wyglądały one na poziomie pojedynczych linii.

Opcja --patch sprawia, że Git generuje tzw. "patch", czyli szczegółowy raport o różnicach pomiędzy poszczególnymi wersjami plików. To bardzo przydatne, gdy chcesz mieć pełną kontrolę nad tym, co dokładnie zmienia się w Twoim projekcie w każdym commicie.

Dlaczego warto używać git log --patch?

W codziennej pracy programisty z Git, polecenie git log --patch może być niezwykle pomocne. Oto kilka powodów, dla których warto korzystać z tego polecenia:

• Śledzenie zmian na poziomie linii: Dzięki git log --patch możesz zobaczyć, które linie kodu zostały dodane, usunięte lub zmodyfikowane w danym commicie.
• Weryfikacja zmian przed zatwierdzeniem: Przed połączeniem nowych zmian z główną gałęzią (np. master), możesz dokładnie sprawdzić, co zostało zmienione w Twoim kodzie.
• Pomoc w rozwiązywaniu konfliktów: Kiedy napotkasz konflikt w kodzie, użycie tego polecenia pozwala na dokładniejsze zrozumienie, co zostało zmienione, co może pomóc w rozwiązaniu problemu.
• Analiza historii projektu: Dzięki temu poleceniu możesz łatwo prześledzić, jak projekt się rozwijał i jakie zmiany były wprowadzane w różnych etapach jego tworzenia.

Jak używać git log --patch?

Użycie git log --patch jest bardzo proste. Wystarczy wydać następujące polecenie w terminalu:

git log --patch

Po uruchomieniu tego polecenia Git wyświetli historię commitów w Twoim repozytorium, pokazując różnice (diff) wprowadzonych zmian. Każdy commit będzie zawierał informacje o autorze, dacie, oraz pełen opis wprowadzonych zmian.

Przykład:

commit 9a3e2f56ac42d1b68ff7562f8ac17ac9cb98c09d
Author: Jan Kowalski 
Date:   Mon Mar 1 12:34:56 2025 +0200

    Naprawa błędu w funkcji obliczającej średnią

diff --git a/main.py b/main.py
index 45b8e4f..e8b0d9f 100644
--- a/main.py
+++ b/main.py
@@ -10,7 +10,7 @@ def calculate_average(numbers):
     if len(numbers) == 0:
         return 0
     total = sum(numbers)
-    return total / len(numbers)
+    return total // len(numbers)

W tym przykładzie możemy zobaczyć, że commit 9a3e2f56ac42d1b68ff7562f8ac17ac9cb98c09d wprowadził zmianę w pliku main.py. Zmiana dotyczyła modyfikacji sposobu obliczania średniej, zmieniając dzielenie na dzielenie całkowite (operator // zamiast /).

Przykłady użycia git log --patch

Teraz, gdy rozumiesz podstawy użycia polecenia git log --patch, zobaczmy kilka przykładów, jak można je wykorzystać w praktyce.

1. Wyświetlanie zmian tylko dla konkretnego pliku

Jeśli chcesz zobaczyć zmiany tylko w jednym pliku, możesz podać nazwę tego pliku w poleceniu:

git log --patch 

Przykład:

git log --patch main.py

To polecenie wyświetli wszystkie commity, które wpłynęły na plik main.py, pokazując zmiany wprowadzone w tym pliku.

2. Ograniczenie liczby commitów

Jeśli chcesz zobaczyć zmiany tylko dla kilku ostatnich commitów, możesz dodać opcję -n z liczbą commitów, które mają być wyświetlone. Na przykład:

git log --patch -n 5

To polecenie pokaże zmiany wprowadzane w ostatnich 5 commitach w Twoim repozytorium.

3. Filtrowanie commitów według daty

Możesz także filtrować wyniki według daty, używając opcji --since lub --until. Na przykład:

git log --patch --since="2025-02-01"

To polecenie pokaże zmiany wprowadzone po 1 lutego 2025 roku. Możesz także używać innych formatów dat, takich jak "2 weeks ago" czy "yesterday".

4. Filtrowanie commitów według autora

Jeśli chcesz zobaczyć zmiany tylko od konkretnego autora, możesz użyć opcji --author. Na przykład:

git log --patch --author="Jan Kowalski"

To polecenie wyświetli tylko te commity, które zostały wprowadzone przez autora o imieniu "Jan Kowalski".

Wskazówki i najlepsze praktyki

Aby maksymalnie wykorzystać polecenie git log --patch, oto kilka wskazówek:

• Używaj opcji --stat: Opcja --stat pozwala na wyświetlenie statystyk dotyczących zmienionych plików, takich jak liczba wierszy dodanych i usuniętych w każdym pliku. To pomaga lepiej zrozumieć skalę zmian wprowadzonych w danym commicie.
• Sprawdzaj zmiany przed mergowaniem: Przed połączeniem gałęzi lub włączeniem nowych zmian do głównej gałęzi, użyj git log --patch do weryfikacji różnic i upewnij się, że zmiany są zgodne z oczekiwaniami.
• Używaj filtru dla większej przejrzystości: Dzięki filtrowaniu wyników za pomocą dat, autorów lub plików, możesz łatwiej analizować zmiany w projekcie i skupić się na najważniejszych aspektach.

Podsumowanie

Polecenie git log --patch to jedno z wielu narzędzi, które Git udostępnia programistom do śledzenia zmian w repozytoriach. Dzięki niemu możesz dokładnie przeanalizować, jakie zmiany zostały wprowadzone w Twoim projekcie, jakie linie kodu zostały dodane lub usunięte, a także śledzić historię commitów z uwzględnieniem różnic w plikach. To świetne narzędzie do analizy kodu i kontroli jakości w złożonych projektach.

Przez odpowiednie wykorzystanie git log --patch będziesz w stanie efektywnie zarządzać historią swojego kodu, weryfikować zmiany oraz lepiej współpracować z zespołem. Życzymy powodzenia w pracy z Gitem i zachęcamy do eksplorowania jego pełnych możliwości!