Katalog roboczy a obszar przygotowania a lokalne repozytorium: zrozumieć trzy lokalne strefy Gita

By Mirko Peters · 2026-08-12

Opanuj trzy lokalne strefy Gita: dowiedz się, jak katalog roboczy, obszar przygotowania i lokalne repozytorium współpracują, aby zapewnić precyzyjną kontrolę nad historią projektu.

Automatically translated with AI from the original post. Read the English original

Poruszanie się po trzech lokalnych obszarach Gita – katalogu roboczym, obszarze przygotowania i lokalnym repozytorium – jest kluczowe, by przejść od chaotycznego kopiowania plików do świadomej kontroli wersji. Ten przewodnik wyjaśnia, jak działa każda strefa, na wzór fizycznego biura, abyś mógł precyzyjnie kontrolować historię projektu.

Najważniejsze wnioski

• Katalog roboczy to aktywny folder projektu, działający jak zagracone biurko, na którym swobodnie edytujesz pliki.
• Obszar przygotowania pełni rolę tacy do przeglądu, zawierającej wyłącznie te zmiany, które wybierzesz za pomocą git add na następny punkt kontrolny.
• Lokalne repozytorium jest szafą na akta, trwale zapisującą przygotowane zmiany jako uporządkowaną historię zatwierdzeń.
• Polecenia git status i git diff stanowią kontrole bezpieczeństwa, pozwalające sprawdzić, co dzieje się w lokalnych obszarach, zanim zapiszesz historię.
• Zrozumienie tych trzech stref zapobiega przypadkowym zatwierdzeniom i pomaga utrzymać historię projektu w czystości i logicznym porządku.

Katalog roboczy: twoje aktywne biurko

Gdy otwierasz folder projektu na komputerze i zaczynasz wprowadzać zmiany, działasz bezpośrednio w pierwszej lokalnej strefie Gita: katalogu roboczym. Traktuj ten folder jak swoje fizyczne biurko w pracy. Zawiera on każdy plik, który otwierasz, tworzysz, modyfikujesz lub usuwasz, w tym kod strony internetowej, dokumentację, pliki konfiguracyjne i obrazy.

Podobnie jak prawdziwe biurko, katalog roboczy może się szybko zagracić podczas eksperymentów. Możesz zacząć przepisywać przycisk logowania, zauważyć błąd ortograficzny w pliku readme i napisać eksperymentalny skrypt, by przetestować nowy układ. Git nie wymusza automatycznie każdej pojedynczej modyfikacji do trwałej historii tylko dlatego, że wystąpiła w tym folderze. Masz swobodę próbowania pomysłów, popełniania błędów i pozostawiania niedokończonej pracy bez trwałej zmiany zapisu projektu.

Aby sprawdzić, co zmieniło się w katalogu roboczym od ostatniego zapisanego punktu kontrolnego, korzystasz z polecenia git status. Mówiąc wprost, zapytanie Gita o status przypomina przegląd wszystkiego, co leży na biurku. Polecenie wskazuje zmodyfikowane, nowe i usunięte pliki, pokazując dokładnie, co się zmieniło od ostatniego zatwierdzenia.

Obszar przygotowania: taca do przeglądu

Obszar przygotowania to być może najbardziej niezrozumiała koncepcja dla programistów nowych w kontroli wersji, głównie dlatego, że jego nazwa brzmi jak tajemnicza techniczna komora magazynowa. Zamiast tego wyobraź sobie obszar przygotowania jako tacę do przeglądu stojącą tuż obok biurka. Na tę tacę kładziesz wyłącznie zmiany przeznaczone na następny punkt kontrolny.

Wyobraź sobie, że rano naprawiasz krytyczny link do resetowania hasła, a jednocześnie zaczynasz eksperymentalną przeróbkę ekranu powitalnego. Poprawkę hasła chcesz z pewnością zapisać, ale przeróbka jest niedokończona i zawiera błędy. Nie chcesz, aby obie zmiany trafiły do tego samego zatwierdzenia.

Polecenie git add wraz z plikiem resetowania hasła umieszcza ten konkretny, gotowy fragment zmian w obszarze przygotowania (staging area). Mimo swojej nazwy git add nie zapisuje trwale Twojej pracy ani niczego nie wysyła na serwer online. Jedynie przygotowuje wybraną, czystą wersję pliku na potrzeby kolejnego punktu kontrolnego. Ta krótka pauza daje Ci ogromną kontrolę. Możesz przejrzeć zmiany w obszarze przygotowania, usunąć elementy dodane przedwcześnie lub dołączyć dodatkowe pliki, które należą do tej samej logicznej całości.

Repozytorium lokalne: szafa na dokumenty

Gdy taca z zmianami zawiera już dokładnie ten zestaw modyfikacji, który chcesz zachować, przenoszą się one do trzeciej strefy Gita: repozytorium lokalnego. Jeśli katalog roboczy to Twoje biurko, a obszar przygotowania to taca do przeglądu, to repozytorium lokalne jest Twoją bezpieczną szafą na dokumenty.

Repozytorium lokalne przechowuje wszystkie Twoje commity i historię projektu bezpośrednio na komputerze, w ukrytych folderach systemowych. Gdy uruchomisz polecenie git commit -m "Fix password reset link", Git pobiera przygotowane zmiany z obszaru przygotowania i zapisuje je jako trwały, nazwany punkt kontrolny.

Ta architektura oparta na lokalności oznacza, że możesz budować kompletną, możliwą do prześledzenia historię projektu bez połączenia z internetem i bez usługi hostingu online. Wszystko dzieje się bezpiecznie na Twoim własnym sprzęcie. Codzienny przepływ pracy staje się wtedy przewidywalnym rytmem: edytujesz pliki w katalogu roboczym, sprawdzasz stan poleceniem git status, wybierasz konkretne zmiany poleceniem git add i zapisujesz swoje decyzje poleceniem git commit.

Podsumowanie

Opanowanie różnicy między katalogiem roboczym, obszarem przygotowania a repozytorium lokalnym zmienia sposób, w jaki podchodzisz do projektów programistycznych. Traktując folder jako przestrzeń roboczą, obszar przygotowania jako tacę do przeglądu, a repozytorium lokalne jako trwałą szafę na dokumenty, zyskujesz pełną kontrolę nad historią projektu.

Aby zgłębić podstawy kontroli wersji, posłuchaj całego odcinka podcastu M365 FM, w którym Mirko Peters wyjaśnia Gita prostym językiem i pokazuje, jak te lokalne mechanizmy wpisują się w szersze procesy pracy zespołowej.

Często zadawane pytania

Jaka jest różnica między katalogiem roboczym a obszarem przygotowania?

Katalog roboczy to aktywny folder projektu, w którym swobodnie edytujesz, tworzysz i usuwasz pliki. Obszar przygotowania to selektywna taca do przeglądu, na którą trafiają wyłącznie te zmiany, które chcesz uwzględnić w kolejnym commicie.

Czy polecenie git add trwale zapisuje moje pliki?

Nie. Polecenie git add przygotowuje pliki, przenosząc je do obszaru przygotowania, ale nie zapisuje ich trwale w historii projektu i nie wysyła ich online. Trwały zapis następuje dopiero po uruchomieniu polecenia git commit.

Czy mogę korzystać z Gita bez usługi hostingu online?

Tak. Git został zaprojektowany do pracy wyłącznie lokalnie na Twoim komputerze. Możesz tworzyć repozytorium lokalne, wykonywać commity, zarządzać gałęziami i przeglądać historię bez łączenia się z GitHubem ani z internetem.

Co zrobić, jeśli przez pomyłkę dodam plik do obszaru przygotowania?

Jeśli dodasz plik zbyt wcześnie, Git udostępnia polecenia usuwania z obszaru przygotowania (np. git reset), które bezpiecznie usuwają plik z obszaru przygotowania i przywracają go do katalogu roboczego, nie tracąc Twoich ostatnich zmian.