Polecenie git diff --stat: Jak Analizować Zmiany w Repozytorium

W świecie programowania i pracy z Git, jednym z kluczowych zadań jest zarządzanie zmianami w kodzie. Zdarza się, że na różnych etapach pracy nad projektem trzeba sprawdzić, jakie dokładnie zmiany zostały wprowadzone do plików. W tym miejscu pojawia się git diff --stat, które pozwala na szybkie sprawdzenie statystyk wprowadzonych zmian w repozytorium. To jedno z tych narzędzi, które bardzo ułatwia pracę z Gitem, szczególnie przy większych projektach, gdzie liczba modyfikacji może być przytłaczająca.

Co to jest polecenie git diff --stat?

W Git, git diff jest podstawowym narzędziem służącym do porównywania zmian wprowadzonych w plikach. Komenda ta pokazuje, jakie dokładnie linie kodu zostały zmienione pomiędzy dwoma stanami repozytorium. Możesz jej używać, aby porównać wersje plików, sprawdzić, które linie zostały dodane lub usunięte, a także ocenić zmiany między różnymi commitami.

git diff --stat to jeden z wielu wariantów tego polecenia, który wyświetla statystyki zmian w formie podsumowania. Zamiast przedstawiać szczegółowe zmiany w każdej linii kodu, jak ma to miejsce w przypadku zwykłego git diff, opcja --stat pokazuje ogólny obraz zmian. Zawiera ona liczbę zmienionych linii oraz informację o tym, które pliki zostały zmodyfikowane.

W skrócie, git diff --stat pozwala na szybkie zapoznanie się z wielkością i zakresem zmian bez konieczności przeszukiwania całego kodu. Jest to idealne narzędzie do oceny skali modyfikacji w projekcie przed podjęciem dalszych działań, takich jak commitowanie lub przeglądanie zmian w kodzie.

Jak działa git diff --stat?

Polecenie git diff --stat działa na bardzo prostych zasadach. Kiedy je wywołasz, Git porówna zmiany wprowadzone w twoim lokalnym repozytorium z ostatnią zatwierdzoną wersją (commit). Otrzymasz zestawienie zmienionych plików oraz liczbę dodanych i usuniętych linii w każdym z nich.

Wyjście z polecenia wygląda zwykle tak:

 file1.txt | 4 +++-
 file2.txt | 2 +-
 2 files changed, 5 insertions(+), 3 deletions(-)

W tym przypadku:

• file1.txt – zmieniono 4 linie, z czego 3 zostały dodane (+) i 1 usunięta (-).
• file2.txt – zmieniono 2 linie, z czego 1 została dodana (+) i 1 usunięta (-).

Na końcu pojawi się podsumowanie: "2 files changed, 5 insertions(+), 3 deletions(-)", co informuje nas, że zmodyfikowane zostały 2 pliki, wprowadzono 5 nowych linii, a 3 linie zostały usunięte.

Przykłady użycia polecenia git diff --stat

Teraz, kiedy mamy już ogólne pojęcie o tym, czym jest git diff --stat, przyjrzyjmy się kilku przykładom, które mogą pomóc w lepszym zrozumieniu jego zastosowania w praktyce.

Przykład 1: Sprawdzenie zmian w plikach przed commitem

Jeśli pracujesz nad projektem i chcesz sprawdzić, jakie zmiany zostały wprowadzone w twoich plikach przed dokonaniem commita, użyj git diff --stat. Po wprowadzeniu jakichkolwiek modyfikacji w kodzie, możesz wydać następujące polecenie:

git diff --stat

Git wyświetli ci listę plików, które zostały zmodyfikowane, a także szczegóły dotyczące liczby dodanych i usuniętych linii. Dzięki temu możesz szybko ocenić, ile pracy zostało wykonane, i upewnić się, że nie zapomniałeś o żadnych zmianach.

Przykład 2: Sprawdzenie zmian między dwoma commitami

Czasami chcesz porównać zmiany pomiędzy dwoma różnymi commitami w historii projektu. W takim przypadku możesz użyć git diff --stat z dwoma identyfikatorami commitów:

git diff --stat commit1 commit2

Git pokaże ci statystyki zmian pomiędzy tymi dwoma commitami. Jest to szczególnie przydatne, jeśli chcesz zobaczyć, jakie zmiany zostały wprowadzone w konkretnym okresie czasu, zanim wykonasz kolejne operacje na repozytorium, takie jak merge czy rebase.

Przykład 3: Sprawdzenie statystyk zmian w konkretnym pliku

Jeśli interesuje cię tylko jeden plik w projekcie, a nie wszystkie zmiany, możesz ograniczyć zakres polecenia do wybranego pliku. W tym celu wystarczy podać nazwę pliku po poleceniu git diff --stat:

git diff --stat file1.txt

Git wyświetli statystyki dla tego konkretnego pliku, co pomoże ci szybko ocenić, jak duża jest skala wprowadzonych zmian.

Przykład 4: Sprawdzenie zmian w gałęzi (branch)

Jeśli pracujesz na różnych gałęziach w projekcie i chcesz sprawdzić, jakie zmiany zostały wprowadzone w konkretnej gałęzi, możesz użyć git diff --stat w odniesieniu do tej gałęzi:

git diff --stat branch_name

Git pokaże ci zmiany, które zostały wprowadzone w wybranej gałęzi względem aktualnej wersji w repozytorium.

Zaawansowane opcje polecenia git diff --stat

Chociaż git diff --stat jest dość prostym poleceniem, Git oferuje kilka dodatkowych opcji, które mogą przydać się w bardziej zaawansowanych scenariuszach:

• --shortstat – Ta opcja pokazuje jeszcze bardziej skrócone statystyki, które obejmują tylko liczbę zmienionych plików oraz liczbę dodanych i usuniętych linii.
• --summary – Opcja ta wyświetla bardziej szczegółowe podsumowanie zmian, w tym informacje o usuniętych i dodanych plikach oraz zmienionych katalogach.
• --numstat – Opcja ta wyświetla statystyki w formacie numerycznym, pokazując liczbę dodanych, usuniętych i zmienionych linii w każdym pliku.

Można je połączyć z podstawowym git diff --stat, aby dostosować wyświetlane informacje do swoich potrzeb.

Podsumowanie

Polecenie git diff --stat to niezastąpione narzędzie do pracy z Gitem, pozwalające na szybkie i wygodne sprawdzenie statystyk zmian w repozytorium. Dzięki niemu możesz łatwo ocenić skalę modyfikacji, co znacznie ułatwia zarządzanie kodem w projektach o dużej skali. Pamiętaj, że Git oferuje także zaawansowane opcje, które pozwalają na dostosowanie wyników do specyficznych potrzeb.

Bez względu na to, czy pracujesz nad małym projektem, czy dużym repozytorium, git diff --stat pomoże ci lepiej zrozumieć, jakie zmiany zachodzą w twoim projekcie i jak możesz je optymalnie zarządzać. Zastosowanie tego polecenia w codziennej pracy z Git to świetny sposób na poprawienie swojej efektywności i organizacji pracy.