GitHub dla początkujących – jak zacząć korzystać z kontroli wersji

Kontrola wersji to jedna z najważniejszych umiejętności każdego programisty i twórcy stron internetowych. GitHub, oparty na systemie Git, jest dziś standardem w branży IT – używają go miliony developerów na całym świecie. Jeśli dopiero zaczynasz swoją przygodę z programowaniem lub chcesz usprawnić swój workflow, ten przewodnik jest właśnie dla Ciebie.

Git a GitHub – jaka jest różnica?

Zanim przejdziemy do praktyki, warto wyjaśnić podstawową różnicę między dwoma pojęciami, które często są mylone.

Git to system kontroli wersji – program działający lokalnie na Twoim komputerze. Śledzi wszystkie zmiany w plikach projektu, pozwala cofać się do poprzednich wersji i zarządzać historią modyfikacji. Git został stworzony przez Linusa Torvaldsa (twórcę Linuksa) w 2005 roku i od tamtej pory stał się nieodłącznym narzędziem każdego developera.

GitHub to natomiast platforma internetowa (serwis hostingowy) zbudowana na bazie Gita. Umożliwia przechowywanie repozytoriów w chmurze, współpracę z innymi programistami, przeglądanie historii zmian przez przeglądarkę i wiele więcej. To coś jak „dysk Google” dla kodu – tyle że z rozbudowanymi funkcjami zarządzania projektami.

Innymi słowy: Git to narzędzie, GitHub to serwis. Możesz używać Gita bez GitHuba (np. lokalnie lub z innymi hostingami jak GitLab czy Bitbucket), ale GitHub bez Gita nie ma sensu.

Dlaczego warto używać kontroli wersji?

Wyobraź sobie, że pracujesz nad stroną internetową. Wprowadzasz dużą zmianę w kodzie i… coś przestaje działać. Bez kontroli wersji musisz ręcznie cofać zmiany lub liczyć na to, że pamiętasz, co zmieniłeś. Z Gitem wystarczy jeden prosty polecenie, by wrócić do dowolnego wcześniejszego stanu projektu.

Oto najważniejsze korzyści z używania kontroli wersji:

• Historia zmian – wiesz dokładnie, co zostało zmienione, kiedy i przez kogo
• Bezpieczeństwo – nigdy nie stracisz pracy, bo zawsze możesz cofnąć się do poprzedniej wersji
• Współpraca – kilka osób może pracować nad tym samym projektem jednocześnie bez nadpisywania swoich zmian
• Eksperymentowanie – możesz testować nowe funkcje na osobnych gałęziach bez ryzyka zepsucia głównej wersji
• Dokumentacja – każda zmiana ma opis (commit message), który tłumaczy, co i dlaczego zostało zmodyfikowane

Jak założyć konto na GitHub?

Zakładanie konta na GitHub jest proste i bezpłatne. Oto kroki:

1. Wejdź na stronę github.com
2. Kliknij przycisk Sign up w prawym górnym rogu
3. Podaj adres e-mail, hasło i nazwę użytkownika (username – będzie widoczna publicznie)
4. Zweryfikuj adres e-mail klikając w link aktywacyjny
5. Uzupełnij profil – dodaj zdjęcie, opis i linki do swoich projektów

Darmowe konto daje dostęp do nieograniczonej liczby publicznych i prywatnych repozytoriów. Plany płatne (GitHub Pro, Team, Enterprise) oferują dodatkowe funkcje, o których powiemy więcej pod koniec artykułu.

Instalacja Gita

Zanim zaczniesz pracować z GitHub, musisz zainstalować Gita na swoim komputerze:

• Windows: Pobierz instalator ze strony git-scm.com. Podczas instalacji możesz pozostawić domyślne ustawienia.
• macOS: Git jest zwykle preinstalowany. Możesz też zainstalować go przez Homebrew: brew install git
• Linux: Użyj menedżera pakietów, np. sudo apt-get install git (Ubuntu/Debian)

Po instalacji otwórz terminal (lub Git Bash na Windows) i skonfiguruj swoje dane:

git config --global user.name "Twoje Imię"
git config --global user.email "twoj@email.com"

Tworzenie pierwszego repozytorium

Repozytorium (repo) to folder projektu śledzony przez Gita. Możesz je utworzyć na dwa sposoby:

Sposób 1 – Nowe repo na GitHub

1. Zaloguj się na GitHub i kliknij zielony przycisk New (lub ikonę „+” w prawym górnym rogu)
2. Podaj nazwę repozytorium
3. Opcjonalnie dodaj opis i wybierz, czy repo ma być publiczne czy prywatne
4. Zaznacz opcję Add a README file – to dobry punkt startowy
5. Kliknij Create repository

Sposób 2 – Inicjalizacja lokalnego folderu

Przejdź do folderu projektu w terminalu i wpisz:

git init

To polecenie tworzy ukryty folder .git, w którym Git będzie przechowywał całą historię projektu.

Podstawowe komendy Git

Oto komendy, których będziesz używał na co dzień:

git clone – pobieranie repozytorium

Aby skopiować istniejące repozytorium z GitHub na swój komputer:

git clone https://github.com/uzytkownik/nazwa-repo.git

Komenda ta pobiera wszystkie pliki i pełną historię projektu.

git add – dodawanie zmian do staging area

Przed zapisaniem zmian musisz je „przygotować” (dodać do tzw. staging area):

git add nazwa-pliku.txt    # dodaje jeden plik
git add .                  # dodaje wszystkie zmienione pliki

git commit – zapisywanie zmian

Commit to zapisanie aktualnego stanu projektu z opisem zmian:

git commit -m "Dodano formularz kontaktowy"

Staraj się pisać krótkie, ale opisowe komunikaty commitów – ułatwi to rozumienie historii projektu.

git push – wysyłanie zmian do GitHub

Po wykonaniu commitów wyślij je na GitHub:

git push origin main

git pull – pobieranie zmian z GitHub

Pobierz najnowsze zmiany z repozytorium zdalnego (np. gdy ktoś inny wprowadził modyfikacje):

git pull origin main

git status – sprawdzanie stanu

Sprawdź, jakie pliki zostały zmienione i co jest przygotowane do commita:

git status

git log – historia commitów

Przeglądaj historię wszystkich commitów w projekcie:

git log --oneline    # skrócona wersja, czytelniejsza

Gałęzie (branches) – praca bez ryzyka

Gałęzie to jeden z najpotężniejszych mechanizmów Gita. Pozwalają pracować nad nowymi funkcjami lub poprawkami w izolacji od głównej wersji kodu (zwykle nazwanej main lub master).

Jak działają gałęzie? Wyobraź sobie drzewo – pień to gałąź główna (main), a każda nowa funkcja to odgałęzienie, które rozwijasz niezależnie. Gdy praca jest gotowa, możesz scalić (merge) gałąź z powrotem do głównej.

git branch nowa-funkcja        # tworzy nową gałąź
git checkout nowa-funkcja      # przełącza się na gałąź
git checkout -b nowa-funkcja   # skrót: tworzy i przełącza jednocześnie
git branch                     # lista wszystkich gałęzi
git merge nowa-funkcja         # scala gałąź z aktualną

Pull Requesty – współpraca i code review

Pull Request (PR) to sposób na zaproponowanie zmian w projekcie i prośba o ich przegląd przed scaleniem z główną gałęzią. To kluczowy element pracy zespołowej.

Jak stworzyć Pull Request na GitHub?

1. Wypchnij swoją gałąź na GitHub: git push origin nazwa-galezi
2. Wejdź na stronę repozytorium na GitHub
3. Kliknij przycisk Compare & pull request (pojawi się automatycznie)
4. Dodaj tytuł i opis zmian
5. Kliknij Create pull request

Inni członkowie zespołu mogą teraz przejrzeć kod, dodać komentarze i zatwierdzić lub odrzucić zmiany. To świetny mechanizm do nauki od doświadczonych programistów.

Plik .gitignore – co wykluczyć z repozytorium

Nie wszystkie pliki powinny trafiać do repozytorium. Pliki konfiguracyjne z hasłami, foldery node_modules czy pliki tymczasowe warto wykluczyć z kontroli wersji.

Utwórz plik .gitignore w głównym folderze projektu i dodaj do niego wzorce plików do ignorowania:

node_modules/
.env
.DS_Store
*.log
dist/
build/

GitHub udostępnia gotowe szablony .gitignore dla różnych języków i frameworków – warto z nich korzystać przy tworzeniu nowego repozytorium.

GitHub Pages – darmowy hosting dla stron statycznych

Jedną z najbardziej praktycznych funkcji GitHub jest GitHub Pages – darmowy hosting dla stron statycznych (HTML, CSS, JavaScript). To świetne miejsce na portfolio programisty, dokumentację projektu czy prostą stronę wizytówkową.

Jak włączyć GitHub Pages?

1. Wejdź w ustawienia repozytorium (zakładka Settings)
2. Przewiń do sekcji Pages
3. Wybierz gałąź źródłową (zwykle main) i kliknij Save
4. Twoja strona będzie dostępna pod adresem: https://twoja-nazwa.github.io/nazwa-repo

GitHub Actions – automatyzacja w pigułce

GitHub Actions to system CI/CD (Continuous Integration/Continuous Deployment) wbudowany bezpośrednio w GitHub. Pozwala automatycznie uruchamiać testy, budować projekt i wdrażać go na serwer po każdym commicie.

Przykładowe zastosowania:

• Automatyczne uruchamianie testów po każdym push
• Budowanie aplikacji i wdrażanie na serwer produkcyjny
• Generowanie dokumentacji
• Wysyłanie powiadomień na Slacka lub e-mail

Akcje są definiowane w plikach YAML w folderze .github/workflows/. To zaawansowana funkcja, ale warto wiedzieć o jej istnieniu już na początku nauki.

Narzędzia GUI – GitHub Desktop i VS Code

Praca z terminalem nie jest obowiązkowa. Dla osób, które wolą graficzny interfejs, dostępne są wygodne narzędzia:

GitHub Desktop

Oficjalna aplikacja desktopowa GitHub (dostępna na Windows i macOS). Umożliwia wykonywanie wszystkich podstawowych operacji Gita bez znajomości komend. Szczególnie polecana dla absolutnych początkujących.

VS Code z integracją Git

Visual Studio Code ma wbudowaną obsługę Gita – widoczną w zakładce Source Control (ikona rozgałęzionego drzewka po lewej stronie). Możesz commitować, przeglądać różnice i zarządzać gałęziami bez opuszczania edytora kodu.

Workflow – typowy dzień z GitHubem

Jak wygląda typowy workflow przy pracy z GitHubem?

1. git pull origin main – pobierz najnowsze zmiany na początku dnia
2. git checkout -b nowa-funkcja – utwórz nową gałąź dla zadania
3. Pracuj nad kodem, wprowadzaj zmiany
4. git add . – dodaj zmienione pliki
5. git commit -m "Opis zmian" – zapisz zmiany z opisem
6. git push origin nowa-funkcja – wypchnij na GitHub
7. Utwórz Pull Request na GitHub
8. Po zatwierdzeniu przez zespół – scal z main

GitHub Free vs GitHub Pro

Darmowe konto GitHub oferuje:

• Nieograniczone publiczne i prywatne repozytoria
• GitHub Pages
• GitHub Actions (2000 minut/miesiąc)
• Podstawowe funkcje zarządzania projektami

GitHub Pro (4 USD/miesiąc) dodaje:

• Zaawansowane narzędzia code review
• Więcej minut GitHub Actions (3000/miesiąc)
• Szczegółowe statystyki repozytoriów
• GitHub Pages dla prywatnych repozytoriów

Dla zdecydowanej większości początkujących i nawet zaawansowanych developerów darmowe konto w zupełności wystarcza.

Podsumowanie

GitHub to narzędzie, bez którego trudno wyobrazić sobie nowoczesne tworzenie stron internetowych i aplikacji. Opanowanie podstaw Gita i GitHuba otworzy przed Tobą drzwi do efektywnej pracy zespołowej, bezpiecznego przechowywania kodu i profesjonalnego zarządzania projektami.

Zacznij od założenia konta, stwórz pierwsze repozytorium i wykonaj kilka commitów. Z czasem praca z Gitem stanie się dla Ciebie tak naturalna jak zapisywanie pliku w edytorze tekstu.

Jeśli budujesz swoją pierwszą stronę internetową i szukasz profesjonalnego wsparcia – skontaktuj się z nami. W Studio Kalmus tworzymy nowoczesne strony internetowe i chętnie podzielimy się naszym doświadczeniem z zakresu dobrych praktyk programistycznych.