0 bodů

Git · 30 min

První repozitář: init, add, commit

Založíš repozitář, naučíš se číst git status, připravovat změny přes git add a ukládat je commitem. Plus jak psát dobré zprávy commitů.

Lidsky řečeno

Představ si fotografa na svatbě. Pracovní složka je sál, kde se pořád něco děje. Index je pódium: fotograf na něj pozve jen ty lidi, které chce mít na snímku. Commit je zmáčknutí spouště: co je na pódiu, je navždy na fotce. Kdo zůstal v sále, na fotce není, ale může přijít na další.

Obtížnost: 1 z 5. Navazuje na lekci Co je Git. Pokud jsi ji přeskočil, stačí vědět, že Git ukládá verze jako commity a před commitem se změny připravují do indexu.

Cyklus práce s Gitem

Každý den s Gitem vypadá podobně:

text
1. upravíš soubory             (editor, echo, cokoli)
2. git status                  co se změnilo?
3. git add soubor              připrav změny do indexu
4. git commit -m "zpráva"      ulož verzi
5. zpátky na 1.

git init: začátek

bash
mkdir web
cd web
git init

Git odpoví Initialized empty Git repository in /home/student/web/.git/. Od teď je složka web repozitář. Kdybys chtěl s Gitem v téhle složce skončit, stačí smazat podsložku .git (a s ní celou historii).

git status: kde jsem a co se změnilo

git status je tvůj nejlepší kamarád. Spouštěj ho před každým add i commit. Soubory rozděluje do tří skupin:

  • Untracked files: nové soubory, které Git zatím nesleduje.
  • Changes not staged for commit: sledované soubory, které se změnily, ale nejsou v indexu.
  • Changes to be committed: co je v indexu a půjde do příštího commitu.

Git v závorkách vždy radí, co můžeš udělat dál, například (use "git add <file>..." to include in what will be committed). Vyplatí se to číst. Krátký výpis dá git status -s: ?? znamená nesledovaný, A přidaný, M změněný (levý sloupec = index, pravý = pracovní složka).

git add: připrav změny

bash
git add index.html          # jeden soubor
git add index.html style.css   # víc souborů
git add .                   # všechno v aktuální složce a podsložkách
git add -A                  # všechny změny v celém repozitáři, i smazání

git add neukládá verzi. Jen říká: „tuhle změnu chci mít v příštím commitu.“ Když soubor po git add ještě upravíš, do indexu šla verze z okamžiku přidání. Nové úpravy musíš přidat znovu.

git commit: ulož verzi

bash
git commit -m "Přidán kontaktní formulář"

Git vypíše něco jako:

text
[main (root-commit) 4cf2ce6] Přidán kontaktní formulář
 1 file changed, 12 insertions(+)
 create mode 100644 kontakt.html

V hranatých závorkách je větev, u prvního commitu poznámka root-commit a zkrácený hash. Pod tím počet změněných souborů a řádků.

Bez -m by skutečný Git otevřel textový editor pro zprávu (v simulaci editor není, proto vždy piš -m). Zkratka git commit -a -m "zpráva" nebo git commit -am "zpráva" přidá před commitem změny všech už sledovaných souborů. Nové soubory ale nepřidá, ty musí projít git add.

Úkol v terminálu

Commit odmítnutý kvůli identitě

Ve složce web je repozitář a soubor index.html je už v indexu. Zkus ho commitnout se zprávou První verze webu. Git commit odmítne, protože neví, kdo jsi. Přečti si chybu, nastav globálně jméno Petr Svoboda a e-mail [email protected] a commit zopakuj.

Načítám terminál…

Vybírej, co do commitu patří

Dobrý commit obsahuje jednu logickou změnu. Opravil jsi chybu v menu a mezitím si zapsal poznámky? To jsou dvě různé věci a poznámky do repozitáře možná vůbec nepatří.

Úkol v terminálu

Commitni jen jeden soubor

V repozitáři přibyly dva nové soubory: style.css (styl webu) a poznamky.txt (tvoje soukromé poznámky). Ulož do nového commitu jen style.css se zprávou Přidán styl. Poznámky nech nesledované.

Načítám terminál…

Úkol v terminálu

Připrav změnu, ale ještě neukládej

Do index.html někdo připsal odstavec s novinkami. Připrav tuhle změnu do indexu, ale commit zatím nedělej. Potom se podívej, jak teď vypadá git status.

Načítám terminál…

Dobrá zpráva commitu

Zprávu čteš za půl roku, až budeš hledat, kdy se něco rozbilo. Pravidla, která se v praxi osvědčila:

  • První řádek krátce (zhruba do 50 znaků) říká co se změnilo: Opravena chyba v odesílání formuláře.
  • Piš konkrétně. oprava, asdf nebo změny nepomůžou nikomu.
  • Pokud je potřeba vysvětlit proč, přidej další odstavec: druhé -m vytvoří nový odstavec zprávy.
  • V týmu dodržuj stejný styl. Často se píše rozkazovacím způsobem v angličtině (Add contact form), v česky psaných projektech třeba Přidán formulář nebo Přidej formulář.
bash
git commit -m "Opravena chyba v menu" -m "Na mobilu se menu nezavíralo po kliknutí na odkaz."
Úkol v terminálu

Ulož všechny sledované změny najednou

Změnil jsi dva sledované soubory, index.html a style.css. Ulož obě změny jedním commitem se zprávou Nové barvy a nadpis, a to jediným příkazem bez samostatného git add.

Načítám terminál…

Pod kapotou · Co přesně dělají add a commit uvnitř

git add spočítá hash obsahu souboru, uloží ho jako objekt blob do .git/objects a do souboru .git/index zapíše cestu, hash a metadata. Index je tedy binární seznam „cesta → blob“, ze kterého git commit sestaví stromy (tree objekty) a nový commit s odkazem na rodiče. Nakonec posune větev (soubor .git/refs/heads/main) na nový hash. Prázdný soubor má v Gitu vždy stejný hash e69de29. Commit bez změn Git odmítne, s --allow-empty ho vytvořit jde (hodí se třeba ke spuštění automatického nasazení).

Procvič si to

Kvíz

Upravil jsi index.html, spustil git add index.html a pak soubor ještě jednou upravil. Co uloží git commit -m "..."?

Kvíz

Co udělá git commit -am "zpráva" s úplně novým souborem kontakt.html?

Kvíz

Co znamená v git status -s řádek ?? poznamky.txt?

Doplň

Doplň příkazy denního cyklu

Kartičky

Opakování: init, add, commit