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 ляп.h старьё.c
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 Replace printf() with 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, прим. пер.), и <<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, прим. пер.). Создать такой список вы можете, просто направив вывод *git log* в файл:
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 — удаление файлов.
188 Мы можем создать патч, отражающий эти изменения, и применить его:
190 $ git diff B A | git apply
192 2. Поскольку в коммите A мы сохранили файлы, то можем получить их обратно:
194 $ git checkout A foo.c bar.h
196 3. Мы можем рассматривать переход от A к B как изменения, которые хотим отменить:
200 Какой способ лучше? Тот, который вам больше нравится. С помощью Git легко получить желаемое, а часто существует много способов это сделать.