Polecenie git ls-files: Jak zarządzać plikami w repozytorium Git

Git to jedno z najpotężniejszych narzędzi do wersjonowania kodu. Każdy programista, niezależnie od tego, czy jest początkujący, czy doświadczony, powinien poznać podstawowe polecenia Gita. Jednym z takich poleceń, które ułatwia zarządzanie plikami w repozytorium, jest git ls-files. Dziś opowiemy o tym, jak to polecenie działa i jakie możliwości daje w pracy z plikami w Gicie.

Co to jest polecenie git ls-files?

Jeśli kiedykolwiek musiałeś szybko sprawdzić, które pliki są aktualnie śledzone przez Git, to polecenie git ls-files jest dokładnie tym, czego szukasz. To polecenie wyświetla listę plików, które są w bieżącym repozytorium i które Git aktualnie śledzi. Bez tego polecenia musielibyśmy ręcznie sprawdzać pliki, co nie byłoby zbyt efektywne.

W skrócie, git ls-files to prosty sposób na uzyskanie pełnej listy plików, które zostały dodane do repozytorium i są zarządzane przez system wersjonowania Git. To polecenie pokazuje wszystkie pliki w różnych stanach: te, które zostały już zatwierdzone (commit), te, które czekają na zatwierdzenie (staged) i te, które są zmieniane, ale nie zostały jeszcze dodane do Gita.

Podstawowa składnia polecenia git ls-files

Składnia polecenia git ls-files jest bardzo prosta:

git ls-files [opcje] [ścieżka]

gdzie:

• opcje to różne parametry, które mogą zmienić zachowanie polecenia (np. filtracja wyników czy pokazanie plików ignorowanych);
• ścieżka to opcjonalna ścieżka do folderu lub pliku, który chcesz przeanalizować (jeśli nie podasz ścieżki, polecenie sprawdzi całe repozytorium).

Jakie informacje daje polecenie git ls-files?

Polecenie git ls-files wyświetli wszystkie pliki w repozytorium, które są obecnie śledzone przez Git. Poniżej przedstawiamy kilka kluczowych informacji, które możemy uzyskać przy jego użyciu:

• Pliki zatwierdzone (committed): To pliki, które zostały dodane do repozytorium i zapisane w historii commitów. Są one w pełni śledzone przez Git i każda ich zmiana może zostać zarejestrowana w nowym commicie.
• Pliki dodane do staging area: To pliki, które zostały dodane do obszaru staging, czyli przygotowane do dodania do historii commitów, ale jeszcze nie zatwierdzone.
• Pliki zmodyfikowane: To pliki, które zostały zmienione, ale nie zostały jeszcze dodane do staging area (czyli nie zostały "git add" do repozytorium).

Jednak to nie koniec! git ls-files ma także opcje, które pozwalają na wyświetlenie szczegółowych informacji o plikach ignorowanych lub tych, które zostały usunięte.

Podstawowy przykład użycia git ls-files

Aby wyświetlić wszystkie pliki śledzone przez Git w repozytorium, wystarczy uruchomić polecenie:

git ls-files

Po jego wykonaniu otrzymasz listę wszystkich plików w repozytorium, które są aktualnie śledzone. Może to wyglądać mniej więcej tak:

src/main.py
src/utils.py
docs/README.md

Przykład 2: Filtracja plików według ścieżki

Jeśli chcesz wyświetlić pliki tylko z konkretnego folderu lub ścieżki, możesz podać ją jako argument. Na przykład:

git ls-files src/

To polecenie wyświetli tylko pliki znajdujące się w katalogu src, które są śledzone przez Git. Dzięki temu łatwo możesz sprawdzić pliki w konkretnych częściach projektu.

Przykład 3: Wyświetlanie plików ignorowanych

Domyślnie git ls-files pokazuje tylko pliki, które są śledzone przez Git. Jeśli chcesz zobaczyć pliki, które są ignorowane przez Git (np. pliki tymczasowe, binarne lub konfiguracyjne), możesz użyć opcji --ignored:

git ls-files --ignored

To polecenie zwróci wszystkie pliki, które są obecnie ignorowane, zgodnie z regułami w pliku .gitignore.

Przykład 4: Pokazywanie plików zmodyfikowanych, ale nie dodanych do staging area

Czasami warto sprawdzić, które pliki zostały zmodyfikowane, ale nie zostały jeszcze dodane do staging area. Możesz to zrobić za pomocą opcji -m:

git ls-files -m

To polecenie zwróci pliki, które zostały zmodyfikowane w repozytorium, ale jeszcze nie dodane do obszaru staging.

Przykład 5: Pokazywanie plików, które zostały usunięte z repozytorium

Często może być przydatne, by sprawdzić, które pliki zostały usunięte z repozytorium, ale nie zostały jeszcze zatwierdzone. W tym celu możesz użyć opcji -d:

git ls-files -d

To polecenie zwróci listę plików, które zostały usunięte, ale nie zostały jeszcze zapisane w historii commitów.

Przykład 6: Wyświetlanie plików z określoną nazwą

Jeśli chcesz wyszukiwać pliki, które pasują do określonego wzorca w nazwie, możesz użyć opcji --name-only. Na przykład:

git ls-files --name-only *.py

To polecenie zwróci wszystkie pliki z rozszerzeniem .py, które są śledzone przez Git. Jest to przydatne, jeśli chcesz wyświetlić pliki w określonym formacie (np. wszystkie pliki Python w repozytorium).

Podsumowanie: Jakie korzyści daje git ls-files?

Polecenie git ls-files jest niezwykle przydatnym narzędziem w codziennej pracy z Git. Dzięki niemu możemy szybko sprawdzić, które pliki są śledzone przez Git, zidentyfikować pliki zmodyfikowane, sprawdzić pliki ignorowane, a także łatwo filtrować i wyszukiwać pliki w repozytorium.