3 Перш ніж занурюватися в нетрі численних команд Git, спробуйте скористатися наведеними нижче простими прикладами, щоб трохи освоїтися. Кожен із них корисний, незважаючи на свою простоту. Насправді перші місяці використання Git я не виходив за рамки матеріалу цього розділу.
5 === Збереження стану ===
7 Збираєтеся спробувати внести якісь радикальні зміни? Попередньо створіть знімок всіх файлів у поточному каталозі за допомогою команд
11 $ git commit -m "Моя перша резервна копія"
13 Тепер, якщо нові правки все зіпсували, можна відновити початкову версію:
17 Щоб зберегти стан знову:
19 $ git commit -a -m "Друга резервна копія"
21 === Додавання, видалення, перейменування ===
23 Наведений вище приклад відстежує лише ті файли, які існували при першому запуску *git add*. Якщо ви створили нові файли або підкаталоги, доведеться сказати Git'у:
25 $ git add readme.txt Documentation
27 Аналогічно, якщо хочете, щоб Git забув про деякі файли:
29 $ git rm kludge.h obsolete.c
30 $ git rm -r incriminating/evidence/
32 Git видалить ці файли, якщо ви не видалили їх самі.
34 Перейменування файлу - це те ж саме, що й видалення старого імені та додавання нового. Для цього є *git mv*, яка має той же синтаксис, що і команда *mv*. наприклад:
36 $ git mv bug.c feature.c
38 === Розширені скасування/повернення ===
40 Іноді просто хочеться повернутися назад і забути всі зміни до певного моменту, тому що всі вони були неправильними. У такому випадку
44 покаже список останніх коммітов і їх хеші SHA1:
46 ----------------------------------
47 commit 766f9881690d240ba334153047649b8b8f11c664
48 Author: Bob <bob@example.com>
49 Date: Tue Mar 14 01:59:26 2000 -0800
51 Замінив printf() на write().
53 commit 82f5ea346a2e651544956a8653c0f58dc151275c
54 Author: Alice <alice@example.com>
55 Date: Thu Jan 1 00:00:00 1970 +0000
58 ----------------------------------
60 Для вказівки комміта достатньо перших декількох символів його хешу, але можете скопіювати і весь хеш. Наберіть:
62 $ git reset --hard 766f
64 для відновлення стану до зазначеного комміта і видалення всіх наступних безповоротно.
66 Можливо, іншим разом ви захочете швидко перескочити до старого стану. У цьому випадку наберіть
70 Ця команда перенесе вас назад у часі, зберігши при цьому більш нові комміти. Однак, як і у фантастичних фільмах про подорожі в часі, якщо тепер ви відредагуєте і закоммітите код, то потрапите в альтернативну реальність, тому що ваші дії відрізняються від тих, що були минулого разу.
72 Ця альтернативна реальність називається «гілкою» і <<branch,трохи пізніше ми поговоримо про це докладніше>>. А зараз просто запам'ятайте, що команда
76 поверне вас назад у теперішнє. Крім того, щоб не отримувати попереджень від Git, завжди робіть commit або скидайте зміни перед запуском checkout.
78 Ще раз скористаємося аналогією з комп'ютерними іграми:
80 - *git reset --hard*: завантажує раніше збережену гру і видаляє всі версії, збережені після тількищо завантаженої.
82 - *git checkout*: завантажує стару гру, але якщо ви продовжуєте грати, стан гри буде відрізнятися від більш нових збережень, які ви зробили в перший раз. Будь-яка гра, яку ви тепер зберігаєте, потрапляє в окрему гілку, що представляє альтернативну реальність, в яку ви потрапили. <<branch,Ми обговоримо це пізніше>>.
84 Можна також відновити тільки певні файли і підкаталоги, перерахувавши їх імена після команди:
86 $ git checkout 82f5 якийсь.файл інший.файл
88 Будьте уважні: така форма *checkout* може мовчки перезаписати файли. Щоб уникнути неприємних несподіванок, виконуйте commit перед checkout, особливо якщо ви тільки вивчаєте Git. Взагалі, якщо ви не впевнені у якісь операції, чи то команда Git чи ні, виконайте попередньо *git commit -a*.
90 Не любите копіювати і вставляти хеші? Використовуйте
92 $ git checkout :/"Моя перша р"
94 для переходу на комміт, опис якого починається з наведеного рядка.
96 Можна також запитати 5-й з кінця збережений стан:
98 $ git checkout master~5
102 У залі суду пункти протоколу можуть викреслювати прямо під час слухання. Подібним чином і ви можете вибирати комміти для скасування.
107 скасує комміт із заданим хешем. Відкат буде збережений у вигляді нового комміта. Можете запустити *git log*, щоб переконатися в цьому.
109 === Создание списка изменений ===
111 Некоторым проектам нужен http://en.wikipedia.org/wiki/Changelog[список изменений] (changelog, прим. пер.). Создайте его такой командой:
113 $ git log > ChangeLog
115 === Скачивание файлов ===
117 Получить копию проекта под управлением Git можно, набрав
119 $ git clone git://сервер/путь/до/файлов
121 Например, чтобы получить все файлы, которые я использовал для создания этого документа,
123 $ git clone git://git.or.cz/gitmagic.git
125 Позже мы поговорим о команде *clone* подробнее.
127 === Держа руку на пульсе ===
129 Если вы уже загрузили копию проекта с помощью *git clone*, можете обновить ее до последней версии, используя
133 === Безотлагательная публикация ===
135 Допустим, вы написали скрипт, которым хотите поделиться с другими. Можно просто предложить им скачивать его с вашего компьютера, но если они будут делать это когда вы дорабатываете его или добавляете экспериментальную функциональность, у них могут возникнуть проблемы. Очевидно, поэтому и существуют циклы разработки. Разработчики могут постоянно работать над проектом, но общедоступным они делают свой код только после того, как приведут его в приличный вид.
137 Чтобы сделать это с помощью Git, выполните в каталоге, где лежит ваш скрипт,
141 $ git commit -m "Первый релиз"
143 Затем скажите вашим пользователям запустить
145 $ git clone ваш.компьютер:/путь/до/скрипта
147 чтобы загрузить ваш скрипт. Здесь подразумевается, что у них есть доступ по ssh. Если нет, запустите *git daemon* и скажите пользователям запустить эту команду вместо вышеприведенной:
149 $ git clone git://ваш.компьютер/путь/до/скрипта
151 С этих пор всякий раз, когда ваш скрипт готов к релизу, выполняйте
153 $ git commit -a -m "Следующий релиз"
155 и ваши пользователи смогут обновить свои версии, перейдя в каталог, с вашим скриптом и набрав
159 Ваши пользователи никогда не наткнутся на версию скрипта, которую вы не хотите им показывать.
161 === Что я сделал? ===
163 Выясните, какие изменения вы сделали со времени последнего коммита:
167 Или со вчерашнего дня:
169 $ git diff "@{yesterday}"
171 Или между определенной версией и версией, сделанной 2 коммита назад:
173 $ git diff 1b6d "master~2"
175 В каждом случае на выходе будет патч, который может быть применен с помощью *git apply*. Попробуйте также:
177 $ git whatchanged --since="2 weeks ago"
179 Часто вместо этого я использую для просмотра истории http://sourceforge.net/projects/qgit[qgit], из-за приятного интерфейса, или http://jonas.nitro.dk/tig[tig] с текстовым интерфейсом, который хорошо работает через медленное соединение. Как вариант, установите веб-сервер, введите *git instaweb* и запустите любой веб-браузер.
183 Пусть A, B, C, D — четыре последовательных коммита, где В отличается от A лишь несколькими удаленными файлами. Мы хотим вернуть эти файлы в D. Как мы можем это сделать?
185 Существует как минимум три решения. Предположим, что мы находимся на D.
187 1. Разница между A и B — удаленные файлы. Мы можем создать патч, отражающий эти изменения, и применить его:
189 $ git diff B A | git apply
191 2. Поскольку в коммите A мы сохранили файлы, то можем восстановить их:
193 $ git checkout A foo.c bar.h
195 3. Мы можем рассматривать переход от A к B как изменения, которые хотим отменить:
199 Какой способ лучше? Тот, который вам больше нравится. С помощью Git легко получить желаемое, и часто существует много способов это сделать.