docs(git): add force-with-lease recovery guide

This commit is contained in:
2026-08-26 11:22:34 +04:00
parent 37f02bf3a0
commit 7d916344d5
+175
View File
@@ -0,0 +1,175 @@
# Памятка: как синхронизировать локальную ветку после `git push --force-with-lease`
Эта инструкция подходит для ситуации, когда удалённая ветка была переписана через `git push --force-with-lease`, и теперь локальная ветка расходится с `origin`.
## Если локальных изменений нет
Если у тебя **нет никаких локальных изменений, которые нужно сохранить**, это хорошо: можно безопасно заменить указатель локальной ветки на удалённую.
В таком случае ничего нужного не пропадёт.
### 1. Сделай `git fetch`
```bash
git fetch
```
### 2. Посмотри, где расходятся ветки
```bash
git log --oneline --decorate --color --graph --all
```
С помощью графа можно увидеть, где локальная и удалённая ветки расходятся в истории.
Например:
```text
feature/student
origin/feature/student
```
`feature/student` — локальная ветка, `origin/feature/student` — состояние этой ветки в удалённом репозитории.
### 3. Перемести указатель локальной ветки на удалённую
Сначала перейди на нужную локальную ветку:
```bash
git checkout feature/student
```
Затем:
```bash
git reset --hard origin/feature/student
```
После этого локальная `feature/student` будет указывать на тот же коммит, что и `origin/feature/student`.
### Весь сценарий целиком
```bash
git fetch
git log --oneline --decorate --color --graph --all
git checkout feature/student
git reset --hard origin/feature/student
```
---
# Если локальные изменения нужно сохранить
В этом случае **не нужно сразу делать `git reset --hard`**.
`reset --hard` изменит состояние рабочей директории и может удалить незакоммиченные изменения.
Сначала нужно сохранить свою работу.
## Вариант 1. Изменения уже закоммичены
Если твои изменения находятся в локальных коммитах, самый простой и надёжный вариант — сначала создать дополнительную ветку, которая будет указывать на текущее состояние:
```bash
git checkout feature/student
git branch backup/feature-student
```
Теперь у тебя есть резервная ветка:
```text
backup/feature-student
↓
твои старые коммиты
feature/student
↓
твои старые коммиты
```
После этого можно безопаснее двигать `feature/student`:
```bash
git fetch
git reset --hard origin/feature/student
```
Резервная ветка `backup/feature-student` при этом никуда не исчезнет.
Если позже выяснится, что какие-то коммиты из старой истории нужны, их можно перенести в новую историю с помощью `git cherry-pick`.
Например:
```bash
git cherry-pick <commit>
```
## Вариант 2. Есть незакоммиченные изменения
Если ты что-то изменил, но ещё не сделал `git commit`, сначала сохрани изменения.
Один из удобных вариантов — временно убрать их в `stash`:
```bash
git stash push -u -m "backup before force-push recovery"
```
После этого рабочая директория станет чистой, и можно выполнять:
```bash
git fetch
git checkout feature/student
git reset --hard origin/feature/student
```
Затем можно вернуть сохранённые изменения:
```bash
git stash pop
```
Git попытается применить их поверх новой истории.
Если возникнут конфликты, их нужно будет разрешить вручную.
---
# Самое важное правило
Перед:
```bash
git reset --hard origin/feature/student
```
нужно ответить на вопрос:
> **Есть ли у меня локальные изменения, которые я не хочу потерять?**
### Если нет
Можно:
```bash
git reset --hard origin/feature/student
```
### Если да, но изменения закоммичены
Сначала создай резервную ветку:
```bash
git branch backup/feature-student
```
### Если да, но изменения ещё не закоммичены
Сначала используй `stash`:
```bash
git stash push -u -m "backup before force-push recovery"
```
И только после этого выполняй `reset --hard`.
**Принцип простой: сначала сохранить то, что может понадобиться, потом двигать указатель ветки.**