Git és GitHub kézikönyv

A GitHub 2021 óta nem fogad jelszót Git-műveletekhez. A legegyszerűbb a GitHub CLI: böngészőben jelentkezel be, és a Git is ezt használja.

gh auth login

Forrás: GitHub Docs: hitelesítés távoli repóhoz (új lapon nyílik)

SSH-kulcs, ha nem akarsz CLI-t: hozz létre egy kulcspárt, a nyilvános felét (~/.ssh/id_ed25519.pub) add hozzá a GitHubon: Settings › SSH and GPG keys. Ezután SSH-címmel klónozz (git@github.com:…).

ssh-keygen -t ed25519 -C "anna@example.com"
ssh -T git@github.com

HTTPS-en jelszó helyett személyes hozzáférési tokent (personal access token) írsz be. A Git Credential Manager megjegyzi, nem kell mindig beírni.

A tokent kezeld jelszóként: ne commitold, ne küldd el senkinek.

Hozd létre a repót a projekt mappájában.

git init

Írd meg előbb a .gitignore-t (függőségek, build-kimenet, .env), hogy ezek be se kerüljenek.

Nézd meg, mi kerülne be, aztán az első commit.

git status
git add .
git commit -m "chore: initial commit"

GitHub CLI-vel egy lépésben létrehozod a GitHub-repót és feltöltöd.

gh repo create <név> --private --source=. --push

Vagy kézzel: a GitHubon hozz létre egy üres repót (README nélkül), és kösd össze. Ha az alapágad még master, azt írd a main helyére.

git remote add origin <url>
git push -u origin main

Töltsd le a repót. A címet a GitHubon a zöld Code gomb alatt találod.

git clone <url>
cd <mappa>

Ne a main-en dolgozz: kezdj saját branchet.

git switch -c feat/<rövid-leírás>

Idegen projekthez, ahová nincs írási jogod, előbb forkold a GitHubon (saját másolat a fiókodban), és a forkot klónozd.

Indulj a friss mainről, így később kevesebb a konfliktus.

git switch main
git pull

Új branch, beszédes névvel.

git switch -c feat/login-oldal

Dolgozz, és közben nézd, mi változott.

git status
git diff

Kis, egy témájú commitok. Csak azt add hozzá, ami ebbe a commitba tartozik.

git add src/login.js src/login.css
git commit -m "feat: add login form"

Töltsd fel. Az első push összeköti a helyi branchet a távolival.

git push -u origin feat/login-oldal

A branch legyen feltöltve.

git push -u origin <branch>

A GitHubon a repó oldalán megjelenik a Compare & pull request gomb. Ellenőrizd az irányt: base: main ← compare: a te branched.

A cím Conventional Commits formátumú legyen, mert squash merge-nél ebből lesz a commit üzenete. A leírásba írd: mit, miért, hogyan teszteld. Closes #42: a beolvasztáskor lezárja a 42-es issue-t.

Terminálból ugyanez a GitHub CLI-vel. Ha még dolgozol rajta, piszkozatként nyisd.

gh pr create --fill
gh pr create --draft

Review után ugyanarra a branchre commitolj és pusholj: a PR magától frissül, nem kell újat nyitni.

Töltsd le a távoli újdonságokat.

git fetch origin

Biztonságos út: olvaszd be a main-t a branchedbe. A történet nem íródik át.

git merge origin/main

Vagy rebase, ha a branchet csak te használod: egyenes történet, de új hash-ek. Ha már pusholtad, utána erővel kell pusholni.

git rebase origin/main
git push --force-with-lease --force-if-includes

Megosztott branchen ne rebase-elj: a többiek munkáját eldobhatod.

Válts vissza a mainre, és húzd le a beolvasztott változást.

git switch main
git pull

Töröld a helyi branchet.

git branch -d feat/login-oldal

Squash merge után a -d gyakran tiltakozik („not fully merged”), mert a Git nem ismeri fel az egybeolvasztott commitot. Ha a GitHubon látod, hogy a PR be van olvasztva, használd a -D-t.

git branch -D feat/login-oldal

A -D be nem olvasztott munkát is töröl. Csak ellenőrzés után.

Takarítsd el a GitHubon már törölt branchek helyi nyomát.

git fetch --prune

Tedd félre a változásokat, az új fájlokkal együtt.

git stash -u

Intézd el a sürgős dolgot a másik branchen.

git switch main

Vissza, és hozd elő a félretett munkát.

git switch -
git stash pop

Ha fájl maradt ki, előbb stage-eld.

git add <fájl>

Javítsd az utolsó commitot. Megnyílik a szerkesztő az üzenettel; --no-edit-tel az üzenet marad.

git commit --amend

Az amend új hash-t ad. Ha már pusholtad, és mások is használják a branchet, inkább új commitot csinálj.

Ez a recept akkor jó, ha még nem pusholtál. Előbb hozz létre egy branchet a mostani ponton: a commitjaid ide kerülnek, te a mainen maradsz.

git branch feat/uj

Állítsd vissza a main-t a távoli állapotra. A --keep megáll, ha mentetlen módosítást írna felül.

git reset --keep origin/main

Válts az új branchre: a commitjaid ott vannak.

git switch feat/uj

Ha stage-elted, előbb vedd ki a stage-ből. Ez még semmit nem dob el.

git restore --staged <fájl>

Eldobás: a fájl a legutóbbi commit állapotára áll vissza.

git restore <fájl>

A mentetlen módosítás végleg elvész. Ha nem vagy biztos benne, inkább git stash -u: félreteszi, és visszahozható.

A commit megszűnik, a változások stage-elve maradnak. Így újra commitolhatod másképp.

git reset --soft HEAD~1

Ha a stage-ből is ki akarod venni őket (a fájlokban megmaradnak):

git reset HEAD~1

A HEAD~1 jelentése: eggyel a mostani commit előtt.

Keresd meg a hibás commit hash-ét.

git log --oneline

Új commit, amely visszacsinálja. A történet nem íródik át, a csapattársaknak semmi dolguk vele.

git revert <hash>
git push

Megosztott branchen ne reset-tel és erővel pusholva vond vissza: a többiek történetét eltöröd.

A reflog megmutatja, hova mutatott a HEAD. Keresd meg a commitot az üzenete alapján.

git reflog

Csinálj új branchet a hash-ből: a commit és minden, ami előtte volt, visszakerül.

git switch -c mentes <hash>

Határidő: a reflog bejegyzései alapból 90 napig maradnak meg, a már semmilyen branchről el nem érhető commitoké 30 napig. A reflog csak a te gépeden van.

Forrás: A git reflog hivatalos leírása (új lapon nyílik)

Nézd meg az érintett fájlokat („both modified”).

git status

Nyisd meg a fájlt. A <<<<<<< és ======= között a te változatod, a ======= és >>>>>>> között a bejövő. Írd meg a végleges változatot, és töröld a jelölőket.

Próbáld ki, hogy működik, aztán jelezd, hogy kész.

git add <fájl>

Merge-nél zárd le committal, rebase-nél folytasd.

git commit
git rebase --continue

Ha elakadtál, minden visszaállítható a kezdés előtti állapotba.

git merge --abort
git rebase --abort

Először a kulcsot érvénytelenítsd vagy cseréld le a szolgáltatónál. Csak ez véd valójában: ami pusholva volt, azt már bárki lemásolhatta.

A commit törlése önmagában nem elég, a titok a történetben marad.

Vedd ki a fájlt a követésből, tedd a .gitignore-ba, és commitold.

git rm --cached .env
git commit -m "chore: stop tracking .env"

A történet tisztítását a GitHub Docs „Removing sensitive data from a repository” leírása szerint végezd (git-filter-repo), és egyeztess a csapattal, mert mindenkinek újra kell klónoznia.

Forrás: GitHub Docs: Removing sensitive data (új lapon nyílik)

A .gitignore csak a még nem követett fájlokra hat. Ami már commitolva van, azt előbb ki kell venni a követésből. A fájl a lemezen megmarad.

git rm --cached <fájl>

Mappánál -r kell.

git rm -r --cached <mappa>

Commitold a változást.

git commit -m "chore: stop tracking ignored files"