Artem: Новая страница: «'''Git''' — система контроля версий. Она позволяет сохранять историю изменений, работать с ветками и обмениваться кодом через удалённый репозиторий, например GitLab или GitHub. На этой странице собраны команды из памятки ''Git_useful_commands.pdf'' с уточнёнными описаниям...»

2026-09-30T13:12:45Z

Новая страница: «'''Git''' — система контроля версий. Она позволяет сохранять историю изменений, работать с ветками и обмениваться кодом через удалённый репозиторий, например GitLab или GitHub. На этой странице собраны команды из памятки ''Git_useful_commands.pdf'' с уточнёнными описаниям...»

Новая страница

'''Git''' — система контроля версий. Она позволяет сохранять историю изменений, работать с ветками и обмениваться кодом через удалённый репозиторий, например GitLab или GitHub.

На этой странице собраны команды из памятки ''Git_useful_commands.pdf'' с уточнёнными описаниями и практическими примерами.

__TOC__

== Как устроена работа с Git ==

{| class="wikitable" style="width:100%;"
! Понятие !! Что означает
|-
| Рабочая папка || Файлы проекта, которые вы редактируете.
|-
| Индекс (staging area) || Подготовленные изменения для следующего коммита. В индекс попадает состояние файла на момент выполнения <code>git add</code>.
|-
| Коммит || Сохранённая версия подготовленных изменений в локальной истории Git.
|-
| Ветка || Отдельная линия разработки, например <code>main</code> или <code>feature/new-command</code>.
|-
| Удалённый репозиторий || Репозиторий на другом компьютере или сервере. Обычно его короткое имя — <code>origin</code>.
|}

Обычная последовательность: '''изменить файлы → проверить изменения → git add → git commit → git push'''.

'''Важно:''' коммит сохраняет изменения локально. Чтобы отправить коммиты на сервер, нужна отдельная команда <code>git push</code>.

== Проверка и создание репозитория ==

=== git --version — версия Git ===

Показывает установленную версию Git.

<syntaxhighlight lang="bash">
git --version
</syntaxhighlight>

=== git init — создать локальный репозиторий ===

Инициализирует репозиторий в текущей папке. Создаёт служебный каталог <code>.git</code>, в котором Git хранит историю и настройки. Файлы проекта автоматически в коммит не попадают.

<syntaxhighlight lang="bash">
cd my-project
git init
</syntaxhighlight>

=== Дополнительно: git clone — скачать существующий проект ===

Создаёт локальную копию удалённого репозитория и обычно настраивает для него имя <code>origin</code>. Замените адрес на URL своего проекта.

<syntaxhighlight lang="bash">
git clone https://gitlab.example.com/team/my-project.git
cd my-project
</syntaxhighlight>

После <code>git clone</code> выполнять <code>git init</code> не требуется.

== Проверка изменений ==

=== git status — состояние проекта ===

Показывает текущую ветку, подготовленные изменения, изменения вне индекса и новые неотслеживаемые файлы. Игнорируемые файлы по умолчанию не выводятся.

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Краткий вариант:

<syntaxhighlight lang="bash">
git status -sb
</syntaxhighlight>

=== git diff — посмотреть изменения ===

Показывает разницу между рабочей папкой и индексом: изменения в отслеживаемых файлах, которые ещё не подготовлены к коммиту.

<syntaxhighlight lang="bash">
git diff
</syntaxhighlight>

Посмотреть изменения, уже подготовленные к следующему коммиту:

<syntaxhighlight lang="bash">
git diff --staged
</syntaxhighlight>

Посмотреть изменения конкретного файла вне индекса:

<syntaxhighlight lang="bash">
git diff -- README.md
</syntaxhighlight>

'''Обратите внимание:''' обычный <code>git diff</code> не показывает содержимое новых неотслеживаемых файлов. Если изменения уже добавлены через <code>git add</code>, смотрите их через <code>git diff --staged</code>.

== Подготовка и сохранение изменений ==

=== git add — подготовить изменения ===

Добавляет в индекс новые файлы, изменения и удаления в указанной области.

Все изменения в текущей папке и её подпапках, кроме игнорируемых неотслеживаемых файлов:

<syntaxhighlight lang="bash">
git add .
</syntaxhighlight>

Только выбранный файл:

<syntaxhighlight lang="bash">
git add README.md
</syntaxhighlight>

Несколько файлов:

<syntaxhighlight lang="bash">
git add README.md bot/main.py
</syntaxhighlight>

Если после <code>git add</code> снова отредактировать файл, новые правки нужно добавить повторно. Перед массовым добавлением проверьте <code>git status</code>, чтобы в коммит не попали пароли, токены или ненужные файлы.

=== git commit -m — сохранить коммит ===

Создаёт локальный коммит из изменений в индексе. Параметр <code>-m</code> задаёт сообщение с описанием изменений.

<syntaxhighlight lang="bash">
git commit -m "Добавлена команда просмотра статистики"
</syntaxhighlight>

Пишите, что именно изменилось. Например: <code>Исправлено переподключение к Telegram</code> вместо <code>update</code>.

== Работа с удалённым репозиторием ==

=== git remote — список подключений ===

Показывает короткие имена настроенных удалённых репозиториев, например <code>origin</code> и <code>upstream</code>.

<syntaxhighlight lang="bash">
git remote
</syntaxhighlight>

=== git remote -v — адреса репозиториев ===

Показывает имена и URL для получения изменений (<code>fetch</code>) и отправки (<code>push</code>).

<syntaxhighlight lang="bash">
git remote -v
</syntaxhighlight>

Для нового проекта, созданного через <code>git init</code>, подключение можно добавить отдельно. Репозиторий на сервере должен уже существовать:

<syntaxhighlight lang="bash">
git remote add origin https://gitlab.example.com/team/my-project.git
</syntaxhighlight>

=== git push — отправить коммиты на сервер ===

Отправляет локальные коммиты и обновляет соответствующие ветки на сервере согласно параметрам команды и настройкам Git. Незакоммиченные правки не отправляются.

Если для текущей ветки уже настроена связь с удалённой веткой:

<syntaxhighlight lang="bash">
git push
</syntaxhighlight>

При первой отправке новой ветки:

<syntaxhighlight lang="bash">
git push -u origin feature/new-command
</syntaxhighlight>

Здесь <code>-u</code> настраивает отслеживаемую удалённую ветку для последующих команд. Замените <code>feature/new-command</code> на имя своей ветки.

=== git pull — получить и включить изменения ===

Получает изменения с сервера и включает их в текущую ветку. Способ включения зависит от параметров и настроек: слияние, rebase или только fast-forward.

<syntaxhighlight lang="bash">
git pull
</syntaxhighlight>

Для обычного обновления без автоматического создания коммита слияния:

<syntaxhighlight lang="bash">
git pull --ff-only
</syntaxhighlight>

Если локальная и удалённая истории разошлись, <code>--ff-only</code> остановит обновление. Перед обновлением проверьте <code>git status</code> и сохраните текущую работу коммитом или через <code>git stash</code>.

== Просмотр истории ==

=== git log — история коммитов ===

Показывает коммиты, доступные из текущей точки истории: идентификатор, автора, дату и сообщение. Это не только ваши коммиты и не обязательно история всех веток.

<syntaxhighlight lang="bash">
git log
</syntaxhighlight>

Последние десять коммитов в кратком виде:

<syntaxhighlight lang="bash">
git log --oneline -10
</syntaxhighlight>

Граф истории по всем локально известным веткам:

<syntaxhighlight lang="bash">
git log --oneline --graph --decorate --all
</syntaxhighlight>

Если вывод открылся в просмотрщике, для выхода обычно используется клавиша '''q'''.

== Работа с ветками ==

=== git branch — локальные ветки ===

Показывает локальные ветки. Текущая ветка отмечена символом <code>*</code>.

<syntaxhighlight lang="bash">
git branch
</syntaxhighlight>

=== git branch -a — локальные и удалённые ветки ===

Показывает локальные ветки и локально сохранённые ссылки на удалённые ветки. Команда сама не обращается к серверу.

<syntaxhighlight lang="bash">
git branch -a
</syntaxhighlight>

Обновить сведения с <code>origin</code> и убрать устаревшие ссылки на удалённые ветки:

<syntaxhighlight lang="bash">
git fetch origin --prune
git branch -a
</syntaxhighlight>

=== git branch NAME — создать ветку ===

Создаёт новую ветку от текущего коммита, но не переключается на неё.

<syntaxhighlight lang="bash">
git branch feature/new-command
</syntaxhighlight>

=== git checkout NAME — переключиться на ветку ===

Переключает текущую ветку и обновляет файлы рабочей папки.

<syntaxhighlight lang="bash">
git checkout feature/new-command
</syntaxhighlight>

Альтернатива для переключения веток:

<syntaxhighlight lang="bash">
git switch feature/new-command
</syntaxhighlight>

Создать ветку и сразу переключиться на неё одной командой:

<syntaxhighlight lang="bash">
git switch -c feature/new-command
</syntaxhighlight>

Используйте либо создание через <code>git branch</code> с последующим переключением, либо <code>git switch -c</code>. Повторно создавать уже существующую ветку не нужно.

=== git branch -D NAME — принудительно удалить ветку ===

Удаляет локальную ветку без проверки того, что её коммиты уже включены в другую историю.

Для обычного удаления сначала используйте вариант с проверкой:

<syntaxhighlight lang="bash">
git branch -d feature/old-task
</syntaxhighlight>

Принудительный вариант из исходной памятки:

<syntaxhighlight lang="bash">
git branch -D feature/old-task
</syntaxhighlight>

'''Важно:''' <code>-D</code> может удалить последнюю ветку, ссылающуюся на нужные коммиты. Используйте его только если содержимое ветки больше не требуется или сохранено в другом месте. Нельзя удалить ветку, которая сейчас используется в рабочем дереве; сначала переключитесь на другую. На сервере ветка этой командой не удаляется.

== Временное сохранение работы ==

=== git stash — отложить незакоммиченные изменения ===

Временно сохраняет изменения отслеживаемых файлов, включая индекс, и возвращает эти файлы к состоянию текущего коммита.

<syntaxhighlight lang="bash">
git stash
</syntaxhighlight>

Сохранить также новые неотслеживаемые файлы и добавить описание:

<syntaxhighlight lang="bash">
git stash push -u -m "Незавершённая работа над статистикой"
</syntaxhighlight>

Посмотреть список сохранений:

<syntaxhighlight lang="bash">
git stash list
</syntaxhighlight>

Вернуть последнее сохранение:

<syntaxhighlight lang="bash">
git stash pop
</syntaxhighlight>

После успешного применения <code>pop</code> удаляет запись из stash. Если возник конфликт, запись сохраняется. Вариант <code>git stash apply</code> применяет изменения, оставляя запись в списке.

'''Примечание:''' обычный <code>git stash</code> не включает новые неотслеживаемые файлы; для них нужен <code>-u</code>. Игнорируемые файлы с <code>-u</code> также не сохраняются. Stash хранится локально и не отправляется обычным <code>git push</code>.

== Пример повседневной работы ==

Пример для существующего репозитория и ветки с настроенным отслеживанием. Выполняйте команды последовательно, проверяя результат каждого шага. При ошибке или конфликте сначала разберитесь с ним.

'''1. Перейти в проект и проверить состояние:'''

<syntaxhighlight lang="bash">
cd my-project
git status
</syntaxhighlight>

'''2. При чистой рабочей папке получить обновления:'''

<syntaxhighlight lang="bash">
git pull --ff-only
</syntaxhighlight>

'''3. Изменить файлы, затем проверить правки:'''

<syntaxhighlight lang="bash">
git status
git diff
</syntaxhighlight>

'''4. Подготовить нужные файлы и проверить будущий коммит:'''

<syntaxhighlight lang="bash">
git add README.md
git diff --staged
</syntaxhighlight>

Замените <code>README.md</code> на нужные файлы. Если нужны все изменения, можно выполнить <code>git add .</code> из корня проекта.

'''5. Сохранить и отправить:'''

<syntaxhighlight lang="bash">
git commit -m "Обновлена документация проекта"
git push
git status
</syntaxhighlight>

== Частые вопросы ==

; Почему после git add команда git diff ничего не показывает?
: Изменения уже находятся в индексе. Выполните <code>git diff --staged</code>.

; Почему изменения не появились в GitLab или GitHub после коммита?
: <code>git commit</code> сохраняет изменения локально. Для отправки нужен успешный <code>git push</code> в нужный удалённый репозиторий и ветку.

; Почему новая ветка не стала текущей после git branch?
: Эта команда только создаёт ветку. Переключитесь через <code>git switch</code> или <code>git checkout</code>.

; Почему push сообщает, что нет upstream-ветки?
: Для новой ветки настройте отслеживание командой <code>git push -u origin ИМЯ_ВЕТКИ</code>, заменив имя на фактическое.

; Почему push отклонён с сообщением non-fast-forward?
: На сервере есть история, которой нет в вашей отправляемой ветке. Получите изменения через <code>git fetch</code>, изучите расхождение и согласуйте истории перед повторной отправкой.

== Источник ==

Подготовлено на основе памятки ''Git_useful_commands.pdf''. Описания переведены и уточнены; дополнительные варианты команд, примеры и ответы на частые вопросы добавлены для практического использования.

[[Категория:Git]]
[[Категория:Полезные команды]]

Git komand - История изменений