Jak začít s GitHub: rychlý start. Podrobný úvod do práce s Git Kompletní průvodce prací s githubem

Odpor ke změnám je základní lidská vlastnost. Pokud Git neexistoval, když jste začali pracovat se systémy správy verzí, je vysoce pravděpodobné, že jste začali se Subversion. Lidé často říkají, že Git je pro začátečníky příliš obtížný. Dovolím si však, abych se s vámi rozcházel.

V tomto článku vám řeknu, jak můžete pomocí Gitu pracovat s vašimi projekty. Předpokládejme, že vytváříte projekt od začátku a chcete používat Git jako systém správy verzí. Po představení základních příkazů se podíváme na to, jak můžete svůj kód publikovat na GitHubu.

Tento článek se bude zabývat základy – jak inicializovat projekt, jak spravovat nové a existující soubory a jak uložit kód do cloudu. Přeskočíme některé složité věci, jako je větvení, protože tento článek je zaměřen na začátečníky.

Instalace Git

Oficiální web Git je dostupný pro různé systémy – Linux, Mac, Windows. V našem případě budeme používat Ubuntu 13.04 a Git budeme instalovat přes apt-get.

Sudo apt-get install git

Počáteční konfigurace

Vytvořme si adresář, ve kterém budeme pracovat. Git můžete také použít k práci na existujícím projektu, v takovém případě nebudete muset vytvářet demo adresář, jak je popsáno níže.

Mkdir my_git_project cd my_git_project

Prvním krokem je inicializace úložiště Git v adresáři projektu. Můžete to udělat pomocí příkazu init, který vytvoří adresář .git se všemi informacemi o vašem projektu.

Git config --global user.name "Shaumik" git config --global user.email " [e-mail chráněný]" git config --global color.ui "auto"

Stojí za zmínku, že pokud neuvedete svou adresu a jméno, budou místo toho použity výchozí hodnoty. V našem případě budou výchozí hodnoty donny a donny@ubuntu.

Také jsme nastavili barvu rozhraní na auto, takže výstup příkazů Git bude barevný. K těmto příkazům přidáváme předponu --global, aby se tyto hodnoty používaly v celém systému a nebylo nutné je nastavovat pro jednotlivé projekty.

Příprava souborů pro odevzdání

Dalším krokem je vytvoření některých souborů. Můžete použít jakýkoli textový editor. Všimněte si, že pokud inicializujete Git na existujícím projektu, nemusíte tento krok dělat.

Kontrola stavu úložiště

Nyní, když máte soubory ve svém projektu, pojďme se podívat, jak s nimi Git zachází. Chcete-li zkontrolovat aktuální stav úložiště, použijte příkaz git status

Přidávání souborů do Git

V tuto chvíli Git nesleduje žádný z našich souborů. Aby k tomu došlo, musíte do Gitu konkrétně přidat soubory. K tomu použijeme příkaz add.

Git add my_file

Po kontrole stavu úložiště vidíme, že jeden ze souborů do něj již byl přidán.

Chcete-li přidat více souborů, použijeme následující (všimněte si, že první soubor jsme přidali dříve, takže přidáme pouze zbývající dva).

Git add myfile2 myfile3

Je možné použít git add rekurzivně, ale buďte opatrní s tímto příkazem. Existují některé soubory (například zkompilované programy), které by neměly být přidány do správy verzí. Pokud použijete git add rekurzivně, takové soubory také skončí v úložišti.

Mazání souborů

Představme si, že jste do úložiště omylem přidali soubor, který tam neměl být. Nebo chcete odstranit soubor ze systému správy verzí. Obecně platí, že příkaz git rm nejen odstraní soubor z úložiště, ale také jej fyzicky odstraní z disku. Chcete-li, aby Git přestal sledovat soubor, ale ponechal jej na disku, použijte následující příkaz:

Git rm --cached [název souboru]

Potvrďte změny

Jakmile vše přidáte potřebné soubory, můžete je svěřit do Gitu. Přemýšlejte o odevzdání jako o snímku stavu projektu v určité fázi, ke kterému se můžete kdykoli vrátit a zobrazit stav projektu v daném okamžiku. Ke každému potvrzení je přidružena zpráva, která je uvedena jako argument za předponou -m

Git commit -m "Můj první commit"

Uveďte prosím zprávu, která bude obsahovat užitečné informace, protože pomáhají porozumět tomu, co přesně se v rámci daného odevzdání změnilo. Vyhněte se jakýmkoli obecným zprávám, jako je „Pravidla chyb“. Pokud máte nástroj na sledování chyb, můžete zadat zprávu jako „Chyba č. 123 opravena“. Dobrý trénink- ve zprávě uveďte název pobočky nebo vylepšení. Například „Správa aktiv – přidána možnost generovat PDF na základě aktiva“ je jasná a srozumitelná zpráva.

Git identifikuje potvrzení dlouhým hexadecimálním číslem. Obvykle není potřeba kopírovat celý řádek, prvních 5-6 znaků stačí k identifikaci konkrétního potvrzení. Ze snímku obrazovky můžete vidět, že náš commit je identifikován číslem 8dd76fc.

Další závazky

Změňme několik souborů poté, co je svěříme. Poté, co jsme je změnili, git status oznámí, že jsme změnili soubory.

Co se v těchto souborech změnilo od předchozího odevzdání, můžete vidět pomocí příkazu git diff. Pokud chcete zobrazit změny pro konkrétní soubor, můžete použít git diff<файл> .

Změny je nutné indexovat a potvrdit. Všechny změněné soubory projektu lze přidat do odevzdání pomocí následujícího příkazu:

Použití tohoto příkazu se můžete vyhnout přidáním volby -a do příkazu git commit . Tento příkaz zaindexuje všechny změněné soubory a potvrdí je. Ale tento přístup může být docela nebezpečný, protože se můžete omylem dopustit něčeho, co jste nechtěli. Řekněme například, že jste otevřeli soubor a omylem jej změnili. Při indexování změněných souborů budete upozorněni na změny v každém souboru. Ale pokud odevzdáte všechny změněné soubory, aniž byste se podívali na nápovědu. git commit -a , pak budou potvrzeny všechny soubory, včetně těch, které jste odevzdat nechtěli.

Jakmile jste indexovali soubory, můžete začít odevzdávat. Jak již bylo zmíněno dříve, můžete zadat zprávu pro odevzdání pomocí přepínače -m. Můžete ale také zadat víceřádkové komentáře pomocí příkazu git commit, který otevře editor konzoly pro zadání komentáře.

Projektový management

Chcete-li zobrazit historii projektu, můžete použít následující příkaz:

Zobrazí kompletní historii projektu ve formě seznamu commitů a informací o nich. Informace o odevzdání obsahují hash odevzdání, autora, čas a zprávu odevzdání. Existuje mnoho typů příkazů git log, se kterými se budete muset při používání větvení Git seznámit. Chcete-li zobrazit podrobnosti konkrétního potvrzení a soubory, které byly změněny, spusťte následující příkaz:

Git show<хеш_коммита>

Kde<хеш_коммита>- hexadecimální číslo spojené s potvrzením. Protože tento manuál Určeno pro začátečníky, nebudeme se zabývat tím, jak vrátit stav do času konkrétního commitu, ani jak spravovat větve.

Git je velmi oblíbený systém správy verzí a kolaborativní vývojový systém pro open source projekty. S Git můžete sledovat změny zdrojový kód svých projektů, vraťte předchozí verze když kritické chyby a také sdílet svůj kód se všemi a přijímat od nich opravy.

Jedná se o výkonný systém, který vám umožní optimalizovat práci na vašich projektech. Neexistují žádné požadavky na jazyk nebo strukturu souborů, takže vývojáři mají naprostou svobodu jednání. V tomto článku se podíváme na to, jak používat git pro začátečníky. Podívejme se na vše velmi podrobně, od konfigurace až po větve projektu.

Tradičně, než přejdeme k příkladům a práci s příkazem, podívejme se na jeho hlavní možnosti a parametry. Syntaxe git je velmi jednoduchá:

$ git options argumenty příkazu

Nejprve se podívejme na možnosti, které ovlivňují provoz celého nástroje:

  • -C- použít zadanou složku úložiště místo aktuální složky;
  • -C parametr=hodnota- použít zadanou hodnotu konfiguračního parametru;
  • -p- procházejte celý výstup pomocí méně;

Nyní se podíváme na příkazy git, je jich o něco více a právě s jejich pomocí provedete všechny hlavní akce:

  • přidat- přidat soubor nebo složku do úložiště git;
  • dopoledne- použít všechny opravy z e-mailu;
  • archiv- vytvořit archiv souborů;
  • půlit- použijte binární vyhledávání k nalezení požadovaného odevzdání;
  • větev- řízení projektových větví;
  • svazek- přesouvání objektů a odkazů v archivu;
  • Překontrolovat- přepínání mezi větvemi;
  • sběr třešní- provádět změny stávajících závazků;
  • čistý- odstranit všechny nesledované soubory a složky projektu;
  • klon- vytvořit kopii vzdáleného úložiště ve složce;
  • spáchat- uložit změny do úložiště;
  • dif- vidět změny mezi commity;
  • vynést- stáhnout vzdálené úložiště;
  • init- vytvořit úložiště;
  • spojit- sloučit dvě větve;
  • SEM- integrovat vzdálené úložiště s místním;
  • TAM- odeslat změny do vzdáleného úložiště;
  • štítek- správa štítků;
  • pracovní strom- správa vývojových stromů.

Argumenty závisí na použitém příkazu, proto se na ně v příkladech podíváme podrobněji.

Jak git funguje?

Takže ze všeho výše uvedeného jste již pravděpodobně pochopili, že správa verzí vám umožňuje zobrazit změny v jakékoli fázi vývoje a také se vrátit k libovolnému bodu. Ale není tomu tak. Změny se ukládají jako potvrzení. V ruštině - fixace. Provedete počáteční potvrzení pro uložení počátečního stavu projektu a poté pro každou změnu. Funguje to jako snímky.

Kromě toho vám git umožňuje přenášet data do vzdálený server. Odesílá se nejen hotová verze, ale také všechny snímky, takže historii změn může vidět kdokoli z týmu. Ke každému snímku je potřeba udělat komentář, takže práce s git bude jednodušší a přehlednější.

Jak používat Git?

Typicky bude struktura projektu Git záviset na velikosti a složitosti vašeho programu. Nejprve ale použijeme projekt skládající se pouze z jedné větve. Každý projekt standardně obsahuje jednu větev, která se nazývá master. Náš první projekt se bude jmenovat test.

Vytvoření projektu

Až bude nastavení git dokončeno, přejděme k vašemu projektu. Na úplném začátku stačí vytvořit složku pro soubory projektu. Pokud budete pracovat na více projektech, vytvořte ve svém domovském adresáři složku git a umístěte tam složky projektu:

mkdir -p ~/git/testing ; cd ~/git/testing

Tento příkaz vytvoří požadovanou strukturu složek a změní aktuální adresář na nově vytvořený. Nyní vytvoříme první soubor našeho projektu:

Projekt je připraven, ale systém pro správu verzí git o něm ještě neví.

Nastavení projektu v git

Než git začne sledovat změny, musíte připravit všechny potřebné konfigurační soubory. Nejprve inicializujeme prázdné úložiště v naší složce:

Jakmile je úložiště vytvořeno, musíte do něj přidat své soubory. Každý soubor musí být přidán samostatně, nebo můžete říci, aby nástroj přidal všechny soubory explicitně. Dokud nepřidáte samotný soubor, nebude sledován. Nové soubory musí být přidány také v budoucnu; Nejprve přidáme aktuální složku:

Pokud vše proběhlo v pořádku, příkaz nevypíše nic.

Provádění změn

Změny také nejsou automaticky sledovány. Potvrzení změn se provádí pomocí příkazu commit. Co se změnilo, musíte naznačit malým komentářem, doslova několika větami. Je dobré se zavázat před každou větší změnou.

Uložíte si tak všechny verze projektu, od té úplně první až po aktuální, a také budete vědět, co, kdy a kde bylo změněno. Chcete-li vytvořit první spuštění odevzdání:

git commit -m "Počáteční potvrzení" -a

Příkazu je třeba předat dva parametry, první je -m, váš komentář, druhý -a znamená, že musíte akci použít na všechny změněné soubory. Tato možnost je použita poprvé, ale obvykle je potřeba zadat upravené soubory nebo adresáře. Můžete například provést toto:

git commit -m soubor "Změněný soubor".

Odesílání změn

Do této chvíle jsme vše dělali v místním úložišti. Git můžete použít lokálně, pokud potřebujete pouze správu verzí, ale někdy potřebujete sdílet informace s ostatními vývojáři a poslat data do vzdáleného úložiště.

Nejprve musíte přidat vzdálené úložiště pomocí příkazu remote. Chcete-li to provést, musíte mu předat adresu URL:

git remote add origin https://github.com/Seriyyy95/testing.git

Poté si můžete prohlédnout seznam vzdálených úložišť:

Můžete použít nejen servery github, ale i jakékoli jiné. Nyní k odeslání změn použijte tento příkaz:

git push origin master

Příkaz push určuje, že chceme poslat data do vzdáleného úložiště, původ je naše nakonfigurované úložiště a hlavní je větev.

Vedení pobočky

Pro jednoduché projekty stačí jedna větev. Pokud je však projekt velký a má několik verzí, včetně testovací verze, možná budete muset vytvořit samostatnou větev pro každou z nich. Nejprve se podíváme na dostupné pobočky:

Volba -a určuje, že na výstupu by měly být všechny větve, dokonce i ty, které nejsou synchronizovány. Hvězdička označuje aktivní větev. Nyní vytvoříme vývojovou větev pomocí příkazu checkout:

git checkout -b rozvíjet

Mezi větvemi můžete také přepínat pomocí stejného příkazu:

git pokladní mistr
$ git checkout rozvíjet

Nyní vytvoříme další soubor:

A přidejte jej do naší nové vývojové větve:

Potvrdíme provedené změny:

git commit -m "vyvinout soubor" vyvinout

větev git
$ ls

Poté přepněte na hlavní větev a podívejte se znovu:

git pokladní mistr
$git větev
$ ls

Žádný soubor zde není, tak to má být. Git má tak užitečnou věc, jako je slučování. S ním můžete sloučit dvě větve. Například přesun kódu z fungující větve do stabilní. Chcete-li to provést, stačí spustit příkaz merge:

git merge develop --no-ff

Před provedením sloučení musíte zadat komentář, proč je to potřeba. Pak pokud znovu spustíte ls, uvidíte, že již existuje požadovaný soubor. Naše příklady git skončily.

závěry

V tomto článku jsme se podívali na to, jak používat git ke správě verzí vašich projektů. Toto jsou jen ty nejzákladnější informace a je toho mnohem víc, co git version control umí, ale podívejte se na to další funkce je nad rámec tohoto článku. Doufám, že vám tento článek pomohl.

Pro lidi je přirozené bránit se změnám. Pokud jste nebyli seznámeni s Git, když jste poprvé začali pracovat se systémy pro správu verzí, pravděpodobně se cítíte pohodlněji se Subversion (SVN).

Lidé často říkají, že Git je pro začátečníky příliš obtížný. V tomto se však dovoluji rozdělit.

V tomto tutoriálu vám ukážu, jak používat Git ve vašich projektech. Řekněme, že budujete projekt od nuly a chcete jej spravovat pomocí Git. Procházením seznamu základních příkazů získáte představu o tom, jak hostovat kód v cloudu pomocí GitHubu.

V tomto článku si povíme o základech Gitu – jak inicializovat své projekty, jak spravovat nové a existující soubory a jak ukládat kód do cloudu.

Nebudeme se dotýkat poměrně složitých částí Gitu, jako je větvení, protože tento tutoriál je určen pro začátečníky.

Instalace Git

Na oficiálních stránkách Git je detailní informace o instalaci na Linux, Mac a Windows. V našem případě použijeme Ubuntu 13.04 pro demo účely, kde nainstalujeme Git pomocí apt-get:

sudo apt-get install git

Počáteční nastavení

Vytvořme si adresář, ve kterém budeme pracovat. Alternativně můžete Git použít ke správě jednoho ze svých stávajících projektů; v tomto případě nebudete muset vytvářet demo adresář jako níže:

mkdir my_git_project cd my_git_project

Prvním krokem je inicializace Git v adresáři. To lze provést pomocí příkazu init, který vytvoří adresář .git obsahující všechny informace související s Git pro váš projekt.

git config --global user.name "Shaumik" git config --global user.email " [e-mail chráněný]" git config --global color.ui "auto"

Je důležité si uvědomit, že pokud neuvedete své jméno a adresu E-mailem, pak budou použity výchozí hodnoty. V našem případě by výchozí hodnoty byly uživatelské jméno donny a e-mailová adresa donny@ubuntu.

Navíc jsme se nastavili pro barvu uživatelské rozhraní nastavte na auto , což způsobí, že výstup příkazů Git bude barevně označen.

Předpona --global před příkazy má zabránit nutnosti zadávat tyto konfigurační příkazy při příštím spuštění projektu Git v našem systému.

Příprava souborů pro odevzdání

Dalším krokem je vytvoření souborů v adresáři. Použít můžete například textový editor Vim. Všimněte si, že pokud se chystáte přidat Git do již existujícího adresáře, nemusíte dělat tento krok:

Zkontrolujte stav úložiště

Nyní, když máme v úložišti několik souborů, pojďme se podívat, jak s nimi Git zachází. Chcete-li zkontrolovat aktuální stav úložiště, musíte použít příkaz git status:

Přidávání souborů do Git pro sledování

Na tento moment nemáme soubory ke sledování pomocí Git. Potřebujeme přidat soubory konkrétně do Gitu, abychom Gitu řekli, co má sledovat.

Přidejte soubory pomocí příkazu add:

Při opětovné kontrole stavu úložiště vidíme, že byl přidán jeden soubor:

Chcete-li přidat více souborů, můžete použít následující příkaz (všimněte si, že jsme přidali ještě jeden soubor pro demonstrační účely):

git add myfile2 myfile3

Můžete použít git add rekurzivně, ale buďte opatrní s tímto příkazem. Existují určité soubory (například kompilované soubory), které jsou obvykle uloženy mimo úložiště Git.

Pokud použijete příkaz add rekurzivně, přidá všechny takové soubory, pokud existují ve vašem úložišti.

Mazání souborů

Ale spuštěním jednoduchého příkazu git rm odstraníte soubor nejen z Gitu, ale také z vašeho lokálního souborový systém! Na

Git přestal sledovat soubor, ale samotný soubor zůstává ve vašem lokálním systému, spusťte následující příkaz:

git rm --uloženo do mezipaměti

Potvrdit změny

Jakmile své soubory hostujete, můžete je odeslat do systému Git. Přemýšlejte o odevzdání jako o zachycení konkrétního okamžiku, ke kterému se můžete vrátit, abyste v tomto okamžiku získali přístup ke svému úložišti.

Ke každému potvrzení můžete připojit zprávu, která je přidána pomocí předpony -m:

git commit -m "Můj první commit"

Dejte svým odevzdáním užitečné zprávy, protože vám to pomůže identifikovat, co jste v daném odevzdání změnili.

Vyhněte se příliš obecným zprávám typu „ Chyby opraveny" Pokud máte nástroj na sledování úkolů, můžete přidat zprávy jako „ Opravena chyba #234».

Je dobrou praxí používat název větve nebo název funkce jako předponu zprávy odevzdání. Například, " Správa majetku: přidána funkce pro generování PDF soubory aktiva“ je smysluplná zpráva.

Git identifikuje odevzdání přidáním dlouhého hexadecimálního čísla ke každému odevzdání. Zpravidla není potřeba kopírovat celý řádek, prvních 5-6 znaků stačí k identifikaci vašeho odevzdání.

Všimněte si, že na snímku obrazovky je naše první potvrzení definováno kódem 8dd76fc.

Další závazky

Nyní změňme několik souborů po našem prvním odevzdání. Po jejich změně uvidíme, že v důsledku spuštění příkazu git status Git zjistil změny v souborech, které monitoruje:

Změny ve sledovaných souborech provedené při posledním odevzdání můžete zkontrolovat pomocí příkazu git diff. Pokud chcete zobrazit změny konkrétního souboru, použijte příkaz git diff :

Chcete-li provést změny ve sledovaných souborech pro další odevzdání, musíte tyto soubory znovu přidat. Všechny sledované soubory můžete přidat spuštěním příkazu:

Použití tohoto příkazu se můžete vyhnout použitím předpony -a k příkazu git commit, který přidá všechny změny do sledovaných souborů.

Tento proces je však velmi nebezpečný, protože může poškodit projekt. Řekněme například, že jste otevřeli soubor a omylem jej změnili.

Pokud umístíte soubory selektivně, všimnete si změn v každém souboru. Pokud však ke svému odevzdání zadáte předponu -a, budou potvrzeny všechny soubory a nebudete schopni odhalit možné chyby.

Jakmile umístíte soubory, můžete začít odevzdávat. Zmínil jsem, že ke každému commitu může být přidružena zpráva, kterou zadáváme pomocí prefixu -m.

Je však možné zadat zprávu na více řádků pomocí příkazu git commit, který otevře interaktivní formulář pro psaní:

Projektový management

Chcete-li zobrazit historii svého projektu, můžete spustit následující příkaz:

Zobrazí se celá historie projektu, což je seznam všech odevzdání a informací o nich. Informace o potvrzení zahrnují hash potvrzení, autora, čas a zprávu potvrzení. Existují různé možnosti protokolu git, které můžete prozkoumat, jakmile si osvojíte koncept větve v Gitu.

Chcete-li zobrazit detailní informace o konkrétním potvrzení a souborech, které byly změněny, spusťte následující příkaz:

git show

Kde toto je hexadecimální číslo spojené s potvrzením. Protože je tento tutoriál zaměřen na začátečníky, nebudeme se zabývat tím, jak se vrátit do stavu konkrétního potvrzení nebo jak spravovat větve.

Hostingový kód v cloudu

Nyní, když jste se naučili spravovat kód ve vašem systému, je čas kód hostit v cloudu.