2019-05-24 04:56:12 +00:00
|
|
|
|
---
|
|
|
|
|
title: "Git: основные команды"
|
|
|
|
|
category: Программирование
|
|
|
|
|
tags: программирование, git
|
|
|
|
|
monofontoptions:
|
|
|
|
|
- Scale=0.8
|
|
|
|
|
...
|
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
<style type="text/css" rel="stylesheet">
|
|
|
|
|
table { table-layout: fixed;}
|
|
|
|
|
</style>
|
2019-05-24 04:56:12 +00:00
|
|
|
|
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
|
|
|
|
## Ссылки
|
|
|
|
|
|
|
|
|
|
* [GitHowTo](https://githowto.com/ru/changes_not_files)
|
|
|
|
|
* [ProGit](https://git-scm.com/book/ru/v2)
|
|
|
|
|
* [Git Pocket Guide](https://github.com/maxliscia/git-pocket)
|
|
|
|
|
|
|
|
|
|
## Установка
|
|
|
|
|
|
|
|
|
|
В Debian/Ubuntu:
|
2019-05-24 04:56:12 +00:00
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
sudo apt-get install git
|
|
|
|
|
```
|
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
## Термины
|
2019-05-24 04:56:12 +00:00
|
|
|
|
|
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| Термин | Англ | Определение |
|
|
|
|
|
| ------ | ------ | ----------------------- |
|
2019-05-27 14:46:54 +00:00
|
|
|
|
| Рабочий каталог | working tree, working directory | Набор файлов в текущем каталоге |
|
|
|
|
|
| Репозиторий | repository, repo | Контейнер, хранящий историю изменений файлов проекта |
|
|
|
|
|
| Индекс | index, staging area | Область между рабочим каталогом и репозиторием, в которой осуществляется подготовка к фиксации |
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| SHA-1 | SHA-1 | Уникальный идентификатор, отражающий информацию об истории |
|
|
|
|
|
| Ветка | branch | Именованная последовательность в истории изменений |
|
|
|
|
|
| Фиксация (коммит) | commit | Набор файлов, записанных в историю одновременно |
|
|
|
|
|
| `HEAD` | `HEAD` | Имя ссылки на последнюю фиксацию в текущей ветке |
|
|
|
|
|
| Метка | tag | Именованная ссылка на некоторую фиксацию в истории |
|
2019-05-24 04:56:12 +00:00
|
|
|
|
|
|
|
|
|
|
2019-05-27 05:45:29 +00:00
|
|
|
|
## Состояния
|
2019-05-24 04:56:12 +00:00
|
|
|
|
|
|
|
|
|
Файлы в рабочем каталоге могут отслеживаться системой контроля версий
|
|
|
|
|
(tracked) или нет (untracked). Отслеживаемые файлы, которые на диаграмме
|
|
|
|
|
обозначены зелёным фоном, могут быть неизменёнными (unmodified),
|
2019-05-28 11:15:34 +00:00
|
|
|
|
изменёнными (modified) или подготовленными к фиксации (indexed).
|
2019-05-24 04:56:12 +00:00
|
|
|
|
|
|
|
|
|
```plantuml
|
|
|
|
|
@startuml
|
|
|
|
|
participant untracked as "Неотслеживамые\n(untracked)"
|
2019-05-27 14:46:54 +00:00
|
|
|
|
box "Отслеживаемые"
|
2019-05-28 11:15:34 +00:00
|
|
|
|
participant staged as "Подготовленные к фиксации\n(indexed)" #55FF55
|
2019-05-24 04:56:12 +00:00
|
|
|
|
participant unmodified as "Неизменённые\n(unmodified)" #99FF99
|
|
|
|
|
participant modified as "Изменённые\n(modified)" #77FF77
|
2019-05-27 14:46:54 +00:00
|
|
|
|
end box
|
2019-05-24 04:56:12 +00:00
|
|
|
|
|
|
|
|
|
untracked -> staged : git add
|
2019-05-27 14:46:54 +00:00
|
|
|
|
staged -> unmodified : git commit
|
2019-05-24 04:56:12 +00:00
|
|
|
|
unmodified -> modified : редактирование
|
|
|
|
|
modified -> staged : git add
|
|
|
|
|
modified -> untracked: git rm --cached
|
|
|
|
|
unmodified -> untracked: git rm --cached
|
|
|
|
|
staged -> untracked: git rm --cached
|
|
|
|
|
@enduml
|
|
|
|
|
```
|
|
|
|
|
|
2019-05-27 14:46:54 +00:00
|
|
|
|
Основные команды, осуществляющие взаимодействие между рабочим каталогом,
|
|
|
|
|
индексом, локальным и удалённым репозиторием, приведены на диаграмме ниже.
|
|
|
|
|
|
|
|
|
|
```plantuml
|
|
|
|
|
@startuml
|
|
|
|
|
participant workspace as "Рабочий каталог\n(working dir)"
|
|
|
|
|
participant index as "Индекс\n(index)" #77FF77
|
|
|
|
|
participant local as "Локальный репозиторий\n(local repository)" #FF7777
|
|
|
|
|
participant remote as "Удалённый репозиторий\n(remote repository)" #7777FF
|
|
|
|
|
|
|
|
|
|
workspace -> local : git commit -a
|
|
|
|
|
workspace -> index : git add (-u)
|
|
|
|
|
index -> local : git commit
|
|
|
|
|
local -> remote : git push
|
|
|
|
|
|
|
|
|
|
== Обновление с сервера ==
|
|
|
|
|
|
|
|
|
|
remote -> workspace : git pull (rebase)
|
|
|
|
|
remote -> local : fetch
|
|
|
|
|
|
|
|
|
|
== Откат изменений ==
|
|
|
|
|
local -[#red]> workspace : git checkout HEAD
|
|
|
|
|
index -[#red]> workspace : git checkout
|
|
|
|
|
|
|
|
|
|
== Сравнение ==
|
|
|
|
|
local -[#blue]> workspace : git diff HEAD
|
|
|
|
|
index -[#blue]> workspace : git diff
|
|
|
|
|
|
|
|
|
|
@enduml
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
## Настройка
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| Команда | Ключи | Описание |
|
|
|
|
|
| ---- | ---------- | ------------ |
|
|
|
|
|
| `git config` | `--global user.name "John Doe"` | Имя текущего пользователя |
|
|
|
|
|
| `git config` | `--global user.email "mail@example.com"` | Почта текущего пользователя |
|
|
|
|
|
| `git config` | `--list` | Вывод текущей конфигурации |
|
|
|
|
|
| `git config` | `--global --list` | Вывод глобальной конфигурации |
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
## Инициализация
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| Команда | Ключи | Описание |
|
|
|
|
|
| ---- | ------ | ------------ |
|
|
|
|
|
| `git init` | `<dir>` | Создать пустой репозиторий в каталоге `<dir>` |
|
|
|
|
|
| `git clone` | `<giturl>` `<dir>` | Создать в каталоге `<dir>` копию репозитория, находящегося по адресу `<giturl>` |
|
|
|
|
|
| `git clone` | `--recursive <giturl>` `<dir>` | Создать в каталоге `<dir>` копию репозитория, находящегося по адресу `<giturl>`, с учётом подмодулей |
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
## Подмодули
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| Команда | Ключи | Описание |
|
|
|
|
|
| ---- | ------ | ------------ |
|
|
|
|
|
| `git submodule` | `add <giturl> <dir>` | Добавить в каталог `<dir>` текущего рапозитория подмодуль, находящийся по адресу `<giturl>` |
|
|
|
|
|
| `git submodule` | `update --recursive --remote` | Обновить подмодули |
|
|
|
|
|
| `git submodule` | `sync --recursive` | Заменить адреса подмодулей на указанные в файле `.gitmodules` |
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
Удаление подмодуля:
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
```sh
|
|
|
|
|
git submodule deinit <path/to/submodule>
|
|
|
|
|
git rm <path/to/submodule>
|
2019-05-27 05:45:29 +00:00
|
|
|
|
```
|
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
## Фиксация
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| Команда | Ключи | Описание |
|
2019-05-28 10:33:01 +00:00
|
|
|
|
| ---- | ---- | ------------ |
|
2019-05-27 14:46:54 +00:00
|
|
|
|
| `git add` | `<filename>` | Подготовить файл `<filename>` к фиксации |
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| `git commit` | | Зафиксировать подготовленные файлы |
|
|
|
|
|
| `git commit` | `-a` | Зафиксировать все отслеживаемые файлы, которые были изменены |
|
2019-05-28 10:33:01 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Удаление
|
|
|
|
|
|
|
|
|
|
| Команда | Ключи | Описание |
|
|
|
|
|
| ---- | ---- | ------------ |
|
2019-05-27 14:46:54 +00:00
|
|
|
|
| `git rm` | `<filename>` | Удалить файл из индекса и рабочего каталога |
|
2019-05-28 10:33:01 +00:00
|
|
|
|
| `git rm` | `-f <filename>` | Принудительное удаление файла |
|
|
|
|
|
| `git rm` | `--cached <filename>` | Удаление файла из проекта, но не из рабочего каталога |
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
## Информация
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| Команда | Ключи | Описание |
|
|
|
|
|
| ---- | ---- | ------------ |
|
|
|
|
|
| `git status` | `-s` | Вывод информации о рабочем каталоге в краткой форме |
|
|
|
|
|
| `git log` | `--oneline` | Вывод журнала изменений в краткой форме |
|
|
|
|
|
| `git ls-files` | | Вывод списка отслеживаемых и подготовленных файлов |
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
|
|
|
|
|
2019-05-28 10:33:01 +00:00
|
|
|
|
## Удалённый репозиторий
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| Команда | Ключи | Описание |
|
2019-05-28 10:33:01 +00:00
|
|
|
|
| ---- | ---- | ------------ |
|
|
|
|
|
| `git remote` | `-v` | Список адресов удалённых репозиториев |
|
|
|
|
|
| `git branch` | `-r` | Список веток в удалённых репозиториях |
|
|
|
|
|
| `git remote` | `add <name> <url>` | Создать ссылку `<name>` на удалённый репозиторий, находящийся по адресу `<url>` |
|
|
|
|
|
| `git remote` | `rename <old> <new>` | Переименовать ссылку `<old>` на `<new>` |
|
|
|
|
|
| `git remote` | `rm <name>` | Удалить ссылку `<name>` |
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-28 10:33:01 +00:00
|
|
|
|
* Обращение к удалённому репозиторию осуществляется по ссылке, создаваемой командой `git remote`
|
|
|
|
|
* Команда `git clone` автоматически создаёт ссылку `origin`
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-28 11:15:34 +00:00
|
|
|
|
|
2019-05-28 10:33:01 +00:00
|
|
|
|
## Отправка изменений
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| Команда | Ключи | Описание |
|
2019-05-28 10:33:01 +00:00
|
|
|
|
| ---- | ---- | ------------ |
|
|
|
|
|
| `git push` | `<remote> <branch>` | Отправить ветку `<branch>` в удалённый репозиторий `<remote>` |
|
|
|
|
|
| `git push` | `<remote> --all` | Отправить все ветки в удалённый репозиторий `<remote>` |
|
|
|
|
|
| `git push` | `--d <remote> <branch>` | Удалить ветку `<branch>` из удалённого репозитория `<remote>` |
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
|
|
|
|
|
2019-05-28 10:33:01 +00:00
|
|
|
|
## Получение изменений
|
2019-05-27 09:00:49 +00:00
|
|
|
|
|
|
|
|
|
| Команда | Ключи | Описание |
|
2019-05-28 10:33:01 +00:00
|
|
|
|
| ---- | ---- | ------------ |
|
|
|
|
|
| `git fetch` | `<remote>` | Получить изменения из всех веток репозитория `<remote>`, но не выполнять слияние |
|
2019-05-28 11:15:34 +00:00
|
|
|
|
| `git fetch` | `<remote> <branch>` | Получить изменения из ветки `<branch>` репозитория `<remote>`, но не выполнять слияние |
|
|
|
|
|
| `git merge` | `<remote>/<branch>` | Выполнить слияние с веткой `<branch>` репозитория `<remote>` |
|
|
|
|
|
| `git pull` | `<remote>` | Получение и слияние |
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
|
|
|
|
|
2019-05-28 11:15:34 +00:00
|
|
|
|
## Ветки
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| Команда | Ключи | Описание |
|
2019-05-28 11:15:34 +00:00
|
|
|
|
| ---- | ---- | ------------ |
|
|
|
|
|
| `git branch` | | Список локальных веток |
|
|
|
|
|
| `git branch` | `-a` | Список локальных и удалённых веток |
|
|
|
|
|
| `git branch` | `<branch>` | Создать ветку `<branch>` |
|
|
|
|
|
| `git checkout` | `<sha-1>` | Перейти к фиксации с идентификатором `<sha-1>` |
|
|
|
|
|
| `git branch` | `-m <old> <new>` | Переименовать ветку `<old>` в `<new>` |
|
|
|
|
|
| `git merge` | `<branch>` | Слить изменения из ветки `<branch>` в текущую ветку |
|
|
|
|
|
| `git branch` | `-d <branch>` | Удалить ветку `<branch>` |
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
|
|
|
|
|
2019-05-28 11:15:34 +00:00
|
|
|
|
## Сравнение
|
2019-05-27 05:45:29 +00:00
|
|
|
|
|
2019-05-27 09:00:49 +00:00
|
|
|
|
| Команда | Ключи | Описание |
|
2019-05-28 11:15:34 +00:00
|
|
|
|
| ---- | ---- | ------------ |
|
|
|
|
|
| `git diff` | | Сравнить рабочий каталог и индекс |
|
|
|
|
|
| `git diff` | `–-cached` | Сравнить индекс и последнюю фиксацию |
|
|
|
|
|
| `git diff` | `HEAD` | Сравнить последнюю фиксацию и рабочий каталог |
|
|
|
|
|
| `git diff` | `--stat` | Краткий вывод результатов |
|
|
|
|
|
| `git diff` | `<sha-1> <sha-1>` | Сравнить две точки с указанными индетификаторами |
|
|
|
|
|
| `git diff` | `<dir> | <file>` | Сравнивать только укзанный каталог `<dir>` или файл `<file>` |
|
|
|
|
|
| `git difftool` | | Отобразить результаты сравнения в программе, определяемой переменной `diff.tool` |
|
2019-05-24 04:56:12 +00:00
|
|
|
|
|