# Используем Гит

**URL:** <https://forum.arduino.ru/t/ispolzuem-git/13564>\
**Category:** Примеры. Алгоритмы. Wiki\
**Created:** [22.Март.2024 07:48:29 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564 "2024-03-22T07:48:29Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![b707](https://forum.arduino.ru/user_avatar/forum.arduino.ru/b707/32/354_2.png) [@b707](https://forum.arduino.ru/u/b707)\
**Post date:** [22.Март.2024 07:48:29 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/1 "2024-03-22T07:48:29Z")

</div>

# Git как полезный инструмент для хобби-программиста

По своей сути Git — это система, предназначенная для отслеживания изменений в файлах. Представьте себе, что у вас есть неограниченная глубина undo-уровней для вашего проекта, позволяющая вам отслеживать свои шаги, независимо от того, насколько сложным становится ваш код. И, как бонус, вы можете иметь доступ к самому проекту и ко всей его истории с совершенно другого компьютера( при условии размещения репозитория на GitHub или локальном Git-сервере).

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

Вот где Git доказывает свою ценность, предлагая мощную систему контроля версий. Эта система позволяет отслеживать изменения в хронологическом порядке, поддерживать несколько версий без дублирования кода и создавать ветви для изучения альтернативных идей. Другое преимущество, хотя и менее актуальное для новичка - в Git много инструментов, облегчающих независимую и при этом согласованную работу над проектом нескольких программистов.

Основные концепции Git вращаются вокруг _репозиториев_, _коммитов_ и _ветвей_. Репозиторий — это набор файлов, изменения в которых вы хотите отслеживать, например файлы в вашем проекте Arduino. Коммиты — это сохраненные изменения, или скажем отпечатки состояния проекта, которые можно использовать как точки восстановления. Ветки - цепочки последовательных коммитов. Параллельные ветки предоставляют безопасную площадку для тестирования новых идей, не влияя на основной код, и их можно объединять или отбрасывать в зависимости от результата.

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

Подводя итог, можно сказать, что Git — это мощный инструмент, который предоставляет беспрецедентные преимущества любителям Arduino и программистам в целом. Это не только помогает поддерживать порядок в вашей кодовой базе, но и дает вам возможность уверенно экспериментировать с новыми функциями. Систематическое отслеживание изменений облегчает устранение багов. Использование Git в ваших проектах означает использование оптимизированного и удобного процесса кодирования, который в конечном итоге приводит к более эффективному и результативному завершению проекта.

Вот несколько ссылок, если вы хотите узнать больше о том, как работает Git и обо всех поддерживаемых им функциях (англ)

- [https://forum.arduino.cc/t/getting-started-with-git/1146345/1](https://forum.arduino.cc/t/getting-started-with-git/1146345/1)
- [https://forum.arduino.cc/t/a-git-workflow-for-simple-arduino-projects/1196852](https://forum.arduino.cc/t/a-git-workflow-for-simple-arduino-projects/1196852)
- [Git Explained: The Basics - DEV Community](https://dev.to/milu_franz/git-explained-the-basics-igc)

---

<div class="post-metadata">

**Author:** ![b707](https://forum.arduino.ru/user_avatar/forum.arduino.ru/b707/32/354_2.png) [@b707](https://forum.arduino.ru/u/b707)\
**Post date:** [22.Март.2024 08:46:55 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/2 "2024-03-22T08:46:55Z")

</div>

# Установка и настройка Git

### Инсталляция в Линукс

> (коммент от b707: В раздел для Линукс я просто скопирую часть из руководства с английского сайта, поскольку на всех моих машинах с Линукс Гит давно установлен. Возможно, и вам не придется его устанавливать вручную, так как многие дистрибутивы Линукс его уже содержат.)

Проверить наличие Git в линукс можно в консоли:

```arduino
david@VirtualUbuntu:~$ git --version

```

Если в ответ вы получаете что-то типа

```arduino
Command 'git' not found, but can be installed with:
sudo apt install git

```

Воспользуемся советом и сделаем как предлагают:

```arduino
david@VirtualUbuntu:~$ sudo apt install git

```

проверка после установки:

```arduino
david@VirtualUbuntu:~$ git --version
git version 2.34.1

```

Теперь Git установлен.

### Инсталляция в Windows

В винде Git обычно отсутствует, поэтому его придется устанавливать вручную. Идем по ссылке [Redirecting…](https://git-scm.com/download/win) и выбираем инсталлятор под свою версию винды. Скачиваем, запускаем.  
У инсталлятора примерно 10-15 страниц разных опций, но для целей начального обучения все они несущественны. Я их все просто пролистнул, подтверждая дефолтный выбор. После установки открываем окно командной строки и проверяем

```arduino
D:\dde\tt>git --version
git version 2.44.0.windows.1

```

### Настройка Git

Git должен знать, кому приписать наши коммиты. Поэтому нам нужно задать имя и адрес электронной почты, по которым он сможет нас идентифицировать. Если вы используете Git локально, вам не обязательно использовать настоящее имя или адрес электронной почты, но там что-то должно быть.

Открываем окно терминала в линукс или командную строку в винде и даем две команды:

```arduino
git config --global user.name "<UserName>"
git config --global user.email "<Email>"

```

Если вы планируете использовать GitHub, то имя и адрес должны совпадать с настройками вашего аккаунта. Если вы хотите сохранить свой адрес электронной почты конфиденциальным, GitHub предоставляет возможность использовать специальный электронный адрес, сгенеренный на сайте. Подробнее смотрите в настройках личных данных GitHub.

---

<div class="post-metadata">

**Author:** ![Alexander](https://forum.arduino.ru/user_avatar/forum.arduino.ru/alexander/32/7067_2.png) [@Alexander](https://forum.arduino.ru/u/Alexander)\
**Post date:** [22.Март.2024 11:22:27 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/3 "2024-03-22T11:22:27Z")

</div>

Разделил(а) эту тему 22.Март.2024 11:22:27 UTC

1 сообщение было перемещено в эту тему: [Обсуждение руководства “Используем Гит”](https://forum.arduino.ru/t/obsuzhdenie-rukovodstva-ispolzuem-git/13571)

---

<div class="post-metadata">

**Author:** ![Alexander](https://forum.arduino.ru/user_avatar/forum.arduino.ru/alexander/32/7067_2.png) [@Alexander](https://forum.arduino.ru/u/Alexander)\
**Post date:** [22.Март.2024 11:21:27 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/4 "2024-03-22T11:21:27Z")

</div>

Разделил(а) эту тему 22.Март.2024 11:21:27 UTC

3 сообщения были перемещены в эту тему: [Обсуждение руководства “Используем Гит”](https://forum.arduino.ru/t/obsuzhdenie-rukovodstva-ispolzuem-git/13571/3)

---

<div class="post-metadata">

**Author:** ![b707](https://forum.arduino.ru/user_avatar/forum.arduino.ru/b707/32/354_2.png) [@b707](https://forum.arduino.ru/u/b707)\
**Post date:** [22.Март.2024 14:24:25 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/5 "2024-03-22T14:24:25Z")

</div>

# Работа с Git из командной строки

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

Работу с Git разберем на очень простом примере - скетче блинк. Суть здесь не в коде, а во взаимодействии с git. Если вам кажется, что глупо отслеживать разработку такого крохотного кода , просто представьте на мгновение, что это большой проект, и эти коммиты включают больше строк и много файлов.

Я использую Линукс, поэтому мои пути к файлам могут отличаться от ваших, но все команды одинаковы на любой ОС.

## Шаг 1: Инициализация и первый коммит

Первый шаг в любом проекте Arduino — это пустой скетч. Нет необходимости начинать именно с пустого скетча, начальное состояние репозитория может быть любое, вы можете добавить в Git свои старые проекты, которыми занимаетесь уже давно - но в учебнике лучше начинать с самого начала.

Итак, я создаю новый скетч и сохраняю его как GitBlink.ino

```arduino
void setup() {

}

void loop() {

}

```

Теперь инициализируем репозиторий для этого скетча. Переходим в каталог, где находится наш файл со скетчем:

```arduino
cd Arduino/GitBlink

```

даем команду

```arduino
git init

```

и получаем в ответ:

```arduino
hint: Using 'master' as the name for the initial branch. This default branch name
hint: is subject to change. To configure the initial branch name to use in all
hint: of your new repositories, which will suppress this warning, call:
hint: 
hint: git config --global init.defaultBranch <name>
hint: 
hint: Names commonly chosen instead of 'master' are 'main', 'trunk' and
hint: 'development'. The just-created branch can be renamed via this command:
hint: 
hint: git branch -m <name>

Initialized empty Git repository in /home/dmit/Arduino/GitBlink/.git/

```

Репо инициализируется пустым. Добавим в него все файлы из текущего каталога (в нашем случае файл один):

```arduino
git add --all

```

Теперь все готово, чтобы выполнить наш первый коммит:

```arduino
git commit -am"Blank"

```

Эту команду вы будете повторять снова и снова, после каждого изменения в проекте, которое вы хотите сохранить. Опция `-a` означает обработать все изменившиеся файлы, а опция `-m` - что далее следует комментарий к коммиту (message). Если давать команду коммит без `-m`, то Git запустит встроенный редактор системы и будет ждать от вас ввода сообщения в нем. В линуксе встроенным консольным редактором по умолчанию является `vim` и я не советую с ним связыватся тем, кто не знает что это такое 🙂 Лучше всегда задавайте коммент к коммиту через опцию `-m`.

Команда выдает в терминал результат своей работы:

```arduino
master (root-commit) 845e514] Blank
 1 file changed, 9 insertions(+)
 create mode 100644 GitBlink.ino

```

Можно приступать к написанию кода.

---

<div class="post-metadata">

**Author:** ![b707](https://forum.arduino.ru/user_avatar/forum.arduino.ru/b707/32/354_2.png) [@b707](https://forum.arduino.ru/u/b707)\
**Post date:** [25.Март.2024 12:22:34 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/6 "2024-03-25T12:22:34Z")

</div>

## Шаг 2: Добавляем код

Нашей целью будет сохранить работающий код в основной ветке Git. В дальнейшем мы будем разрабатывать другие ветки и объединять их с основной. Но сейчас у нас только пустой скетч, так что это было бы просто глупо.

Предположим, мы хотим мигать светодиодом с частотой 1 Гц. Итак, давайте напишем Blink.

```arduino
void setup() {
  pinMode(13, OUTPUT);
}

void loop() {
  digitalWrite(13, HIGH);
  delay(500);
  digitalWrite(13, LOW);
  delay(500);
}

```

Сохраняем и компилируем. Компиляция прошла без ошибок, так что мы можем выполнить коммит:

```arduino
git commit -am "Blink"

```

Команда та же, что и раньше, только я изменил комментарий с «Пустой»(Blank) на «Мигать» (Blink). Теперь это сохранено в истории 🙂

> Опция `-a` говорит команде `commit`, что мы хотим зафиксировать все изменения и скрывает от нас промежуточную стадию - индексацию или staging, на которой мы можем выбрать только некоторые изменения для фиксации. подробнее об этом - в [Приложении А сообщение 12](https://forum.arduino.ru/t/ispolzuem-git/13564/12).

## Шаг 3: Продолжаем разработку

Мне кажется, этот код нехорош. К чему эти магические числа? Добавим осмысленности введением переменных:

```arduino
const int ledPin = 13;
const int delayTime = 500; 

void setup() {
  pinMode(ledPin, OUTPUT);
}

void loop() {
  digitalWrite(ledPin, HIGH);
  delay(delayTime);
  digitalWrite(ledPin, LOW);
  delay(delayTime);
}

```

Снова сохраняем и компилируем. Компилируется успешно, значит мы можем закоммитить изменения.

```arduino
git commit -am "Added Variable Names"

```

Обратите внимание, что я использовал более длинное сообщение о фиксации. Это наш комментарий. Когда мы позже будем просматривать лог изменений, эта маленькая строчка должна рассказать нам, почему мы сохранили эту версию. Как и в случае с комментариями в коде, совсем немного инфы здесь может избавить вас от большой головной боли в дальнейшем.

Отличный код и работает хорошо, отправляем заказчику 🙂

---

<div class="post-metadata">

**Author:** ![b707](https://forum.arduino.ru/user_avatar/forum.arduino.ru/b707/32/354_2.png) [@b707](https://forum.arduino.ru/u/b707)\
**Post date:** [25.Март.2024 12:54:55 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/7 "2024-03-25T12:54:55Z")

</div>

## Шаг 4: Branches

Клиент тут же перезванивает: " - Там же должна быть кнопка, чтобы остановить мигание! Это же очевидно, разве об этом надо отдельно говорить? Ты должен был сам догадаться!"

Итак, возвращаемся к монитору.

Но прежде чем мы добавим что-нибудь в этот код, давайте создадим ветку (branch). У нас есть работающий код, и мало ли как оно сложится при добавлении кнопки. В основной ветке всегда должен быть проверенный код. Каждый раз, когда я добавляю что-то новое, я сначала создаю ветку. Скоро мы увидим почему.

Мы используем команду git checkout с флагом -b, который указывает гит создать новую ветку, и даем ей имя:

```arduino
git checkout -b button

```

Теперь начнем добавлять кнопку… я тут что-то накидал, посмотрите что не так…

```arduino
const int ledPin = 13;
const int delayTime = 500;
const int buttonPin = 7;

void setup() {
  pinMode(ledPin, OUTPUT);
  pinMode(buttonPin, INPUT_PULLUP);
}

void loop() {
  // Мигаем только если кнопка не нажата
  if (digitalRead(buttonPin) == HIGH) {
    digitalWrite(ledPin, HIGH);
    delay(delayTime);
    digitalWrite(ledPin, LOW);
    delay(delayTime);
  }
}

```

и оно даже компилируется… скорей коммит:

```arduino
git commit -am "new button code"

```

(обратите внимание, что мы чаще всего используем эту команду - снова и снова.)

Мы тестируем код и он вроде работает - вроде как. Кнопка что-то не очень отзывчивая… Проблема в задержках.

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

Итак, мы вернемся в основную ветку master, и создадим еще одну ветку, чтобы спокойно поработать над кодом с миллис, а затем вернемся к этой кнопке, как только избавимся от задержек.

---

<div class="post-metadata">

**Author:** ![b707](https://forum.arduino.ru/user_avatar/forum.arduino.ru/b707/32/354_2.png) [@b707](https://forum.arduino.ru/u/b707)\
**Post date:** [25.Март.2024 16:15:55 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/8 "2024-03-25T16:15:55Z")

</div>

## Шаг 5: Возвращаемся назад к работающему коду

Я не стану начинать новую ветку для перевода кода на миллис от ветки кнопки. Хорошим тоном будет не смешивать разные изменения. Я хочу вернуться и создать новую ветку от основной ветки master, потому что это наш основной код. Поэтому сначала нужно выполнить chekout ветки мастер, а затем создать новую ветку.

Это шаг, на котором вы поймете, почему git — это круто. Пожалуйста, проделайте это с открытой Arduino IDE и посмотрите, что там произойдет. Код волшебным образом, автоматически и мгновенно вернется к старой версии из основной ветки.

Команда для извлечения ветки — это просто `git checkout` и имя ветки.

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

```arduino
git status

```

и он рапортует, что все отлично, в текущей ветке “нечего фиксировать”:

```arduino
On branch button
nothing to commit, working tree clean

```

Если бы это было не так, нам бы пришлось сначала закоммитить или спрятать ([stash](https://git-scm.com/docs/git-stash)) изменения.

> (b707 - последним я никогда не пользовался и не очень понимаю, как это работает).

Но раз статус сказал, что директория чистая - мы можем, наконец, извлечь ветку мастер:

```arduino
git checkout master

```

и код в Ардуино ИДЕ, как волшебству, вернется к прежней версии:

```arduino
const int ledPin = 13;
const int delayTime = 500; 

void setup() {
  pinMode(ledPin, OUTPUT);
}

void loop() {
  digitalWrite(ledPin, HIGH);
  delay(delayTime);
  digitalWrite(ledPin, LOW);
  delay(delayTime);
}

```

> (b707 важно! - В ИДЕ версий 1.х никакого “волшебства” не происходит, ИДЕ не умеет отслеживать изменения в файлах, происходящие за пределами самой ИДЕ. Чтобы не попасть в довольно неприятную ситуацию, лучше закрывать окно ИДЕ перед выполнением команд Git, которые меняют содержимое проекта)

Но версия с кнопкой не сгинула. Гит ее просто спрятал внутри своего файла версий.

Снова создаем новую ветку, как мы это уже делали прежде:

```arduino
git checkout -b BWoD

```

> BWoD - BlinkWithoutOfDelay

и можем занятся внедрением миллис:

```arduino
const int ledPin = 13;
const int delayTime = 500;

unsigned long previousMillis;
uint8_t ledState = LOW;

void setup() {
  pinMode(ledPin, OUTPUT);
}

void loop() {
  if (millis() - previousMillis >= delayTime) {
    ledState = 1 - ledState;
    digitalWrite(ledPin, ledState);
  }
}

```

код компилируется, поэтому я снова фиксируюсь:

```arduino
git commit -am "change to BWoD"

```

Но… он не работает. Ага… вижу, мы с вами посадили баг. Нужно добавить `previousMillis = millis();` после оператора условия.

Добавляем и проверяем. Теперь все Ок. Фиксируемся снова:

```arduino
git commit -am "bugFix add update previousMillis"

```

проблема решена.

В следующей части мы выполним слияние этой ветки с основным кодом.

---

<div class="post-metadata">

**Author:** ![b707](https://forum.arduino.ru/user_avatar/forum.arduino.ru/b707/32/354_2.png) [@b707](https://forum.arduino.ru/u/b707)\
**Post date:** [26.Март.2024 09:50:17 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/9 "2024-03-26T09:50:17Z")

</div>

## Шаг 6: Собираем изменения вместе

Итак, что мы имеем:

 ![git3](https://forum.arduino.ru/uploads/default/original/2X/a/ad7ad15381551c35fc9e56fc52cad9e5f707fdad.png)

у нас есть три разные версии нашего кода в трех разных ветвях Git. При этом это только один файл, а не папка, полная исходных текстов с разными именами. В этом красота Git. Однако у нас нет единого готового кода - есть главная ветка с кодом, использующим задержки, есть ветка `button` с тем же кодом и добавленной кнопкой и ветка `BWoD` с кодом «Блинк без делей», но без кнопки.

Помните, как я говорил, что у нас есть рабочий код только в основной ветке? Что ж, теперь код ветки BWoD тоже работает. Поэтому пришла пора слить ветку `BWoD` в ветку master.

Команда для этого — `git merge`. Прежде всего следует перейти в ветку мастер командой `checkout`.

> Помните, при слиянии двух веток GIt должен находится в ветке, которая принимает изменения. Это не одно и то же и результат вливания ветки `BWoD` в `мастер` может отличатся от вливания `мастер` в `BWoD`.

Итак, сначала мы выполняем

```arduino
git checkout master

```

а затем объединим с ней ветку `BWoD`.

```arduino
git merge BWoD

```

Это обьединит все изменения. И опять же, вы можете сделать это с открытой IDE и наблюдать, как текст просто волшебным образом меняется на экране…

> Пользователям Ардуино ИДЕ 1.х придется закрыть ИДЕ и войти в нее вновь, чтобы исходные файлы перезагрузились.

В консоли вы увидите примерно такой вывод Git:

```arduino
Updating d12af3d..9ec2432
Fast-forward
 GitBlink.ino | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

```

И вот что стало с нашим деревом версий:

 ![git4](https://forum.arduino.ru/uploads/default/original/2X/5/5043905a4114200bd857ad894a1bc797d1dbe36a.png)

Git пишет, что выполнил так называемый `fast-forward`.

> Если вы сравните изменения в дереве с картинкой в начале этой части - вы можете заметить, что никакого слияния ветвей не потребовалось. Ветка мастер и так была частью ветви BWoD. Что сделал Гит - это “перемотал” (fast-forward) указатель ветки мастер на вершину ветви BWoD.

Естесственно, что при таком слиянии в основной ветке не было изменений, которые конфиктовали бы с изменениями в ветке BWoD. Так бывает не всегда. Как разрешать конфликты, будет рассказано в части 8.  
Теперь в нашей основной ветке есть код Blink Without Delay. Также после успешного слияния автоматически выполняется фиксация, поэтому у нас есть чистое рабочее дерево для дальнейшей разработки.

При желании, вы можете удалить ветку BWoD. Она нам больше не нужна.

> (b707 - я обычно оставляю все ветки, чтобы проще потом проследить историю)

Используйте флаг -d с именем ветки, чтобы удалить ветку.

```arduino
git branch -d BWoD

```

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

---

<div class="post-metadata">

**Author:** ![b707](https://forum.arduino.ru/user_avatar/forum.arduino.ru/b707/32/354_2.png) [@b707](https://forum.arduino.ru/u/b707)\
**Post date:** [26.Март.2024 15:19:22 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/10 "2024-03-26T15:19:22Z")

</div>

## Шаг 7: Обновление другой ветки

Можно было бы слить обновленную ветку `мастер` в ветку кнопки. Но интереснее перенести точку ответвления ветки `button` от основного ствола выше наших текущих изменений, так, будто мы ответвили ее только что. Заодно это позволит нам изучить новую команду - `rebase`.

Как и раньше, сначала надо перейти в ветку, которую мы собираемся изменять:

```arduino
git checkout button

```

Посмотрите на код в IDE. Что-то знакомое? Да это же версия скетча из шага 4!

```arduino
const int ledPin = 13;
const int delayTime = 500;
const int buttonPin = 7;

void setup() {
  pinMode(ledPin, OUTPUT);
  pinMode(buttonPin, INPUT_PULLUP);
}

void loop() {
  // only run when button is not pressed
  if (digitalRead(buttonPin) == HIGH) {
    digitalWrite(ledPin, HIGH);
    delay(delayTime);
    digitalWrite(ledPin, LOW);
    delay(delayTime);
  }
}

```

Попробуем учесть в этом коде изменения из ветки мастер, для этого дадим команду `rebase` с именем ветки, на вершину которой мы хотим переместить ветвь button:

```arduino
git rebase master

```

И у-у-пс… случилось что-то ужасное… Вот что мы видим в консоли:

```arduino
Auto-merging GitBlink.ino
CONFLICT (content): Merge conflict in GitBlink.ino
error: could not apply 87e74c8... new button code
hint: Resolve all conflicts manually, mark them as resolved with
hint: "git add/rm <conflicted_files>", then run "git rebase --continue".
hint: You can instead skip this commit: run "git rebase --skip".
hint: To abort and get back to the state before "git rebase", run "git rebase --abort".
Could not apply 87e74c8... new button code

```

Две ветви, которые мы пытались обьединить, имеют несовместимые изменения. Это называется “конфликт слияния” (merge conflict). Мы плохо спланировали работу со скетчем и изменили в нем одни и те же участки дважды в разных ветвях. Теперь Git не знает, как обьединить эти изменения. Ну что ж, пусть это послужит нам уроком . Хорошее правило - не работать с одними и теми же частями кода одновременно более чем в одной ветви.  
Но что же делать с проектом? - Можно ли как-то все-таки обьединить ветви? - да, но нам придется приобрести опыт разрешения конфликтов.

---

<div class="post-metadata">

**Author:** ![b707](https://forum.arduino.ru/user_avatar/forum.arduino.ru/b707/32/354_2.png) [@b707](https://forum.arduino.ru/u/b707)\
**Post date:** [27.Март.2024 09:39:14 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/11 "2024-03-27T09:39:14Z")

</div>

## Шаг 8: Разрешение конфликтов

Что же случилось с нашим кодом? Теперь в ИДЕ он выглядит так:

```arduino
const int ledPin = 13;
const int delayTime = 500;
<<<<<<< HEAD

unsigned long previousMillis;
uint8_t ledState = LOW;
=======
const int buttonPin = 7;
>>>>>>> 87e74c8 (new button code)

void setup() {
  pinMode(ledPin, OUTPUT);
  pinMode(buttonPin, INPUT_PULLUP);
}

void loop() {
<<<<<<< HEAD
  if (millis() - previousMillis >= delayTime) {
    previousMillis = millis();
    ledState = 1 - ledState;
    digitalWrite(ledPin, ledState);
=======
  // only run when button is not pressed
  if (digitalRead(buttonPin) == HIGH) {
    digitalWrite(ledPin, HIGH);
    delay(delayTime);
    digitalWrite(ledPin, LOW);
    delay(delayTime);
>>>>>>> 87e74c8 (new button code)
  }
}

```

и уж точно не скомпилируется со всем этим мусором.

Разрешение конфликтов - это тот случай, где использование графического интерфейса НАМНОГО бы упростили то, что я собираюсь сделать. Но ради обучение проделаем это старым добрым способом.

Прежде всего разберемся с используемым синтаксисом. Каждый участок кода, где Гит не смог объединить изменения из двух ветвей, называется “конфликтом” и обозначен в тексте. Давайте посмотрим на первый конфликт:

```arduino
<<<<<<< HEAD

unsigned long previousMillis;
uint8_t ledState = LOW;
=======
const int buttonPin = 7;
>>>>>>> 87e74c8 (new button code)

```

Строки `<<<<<<< HEAD` и `>>>>>>> 87e74c8 (new button code)` указывают границы конфликта. Они всегда идут парами, и вся работа будет выполняться между ними. В середине `=======`. Все, что расположено выше и обозначено `HEAD` - из ветки `master`. Все, что ниже - из ветки `button`. Конфликт означет, что git не знает, как вы хотите соединить их вместе.

В этом случае он видит, что мы добавили новые переменные, но не знает, добавили ли мы одно и то же дважды и просто назвали по-другому, или это действительно две разные вещи, которые нужны нам обе. Мы хотим сохранить все переменные, поэтому просто удаляем пометки, поставленные git:

```arduino
unsigned long previousMillis;
uint8_t ledState = LOW;

const int buttonPin = 7;

```

Второй конфликт в loop():

```arduino
void loop() {
<<<<<<< HEAD
  if (millis() - previousMillis >= delayTime) {
    previousMillis = millis();
    ledState = 1 - ledState;
    digitalWrite(ledPin, ledState);
=======
  // only run when button is not pressed
  if (digitalRead(buttonPin) == HIGH) {
    digitalWrite(ledPin, HIGH);
    delay(delayTime);
    digitalWrite(ledPin, LOW);
    delay(delayTime);
>>>>>>> 87e74c8 (new button code)
  }
}

```

Мы хотим сохранить кое-что в нижней части, строку кнопок, но нам нужна и верхняя часть в операторе if. Так что нам придется поработать и отредактировать это вручную, чтобы объединить их:

```arduino
void loop() {
  // only run when button is not pressed
  if (digitalRead(buttonPin) == HIGH) {
    if (millis() - previousMillis >= delayTime) {
      previousMillis = millis();
      ledState = 1 - ledState;
      digitalWrite(ledPin, ledState);
    }
  }
}

```

Полученный код уже компилируется и может быть “закоммичен”.  
Спросим `git status`, что нам делать дальше:

```arduino
interactive rebase in progress; onto aea6e98
Last command done (1 command done):
   pick 87e74c8 new button code
No commands remaining.
You are currently rebasing branch 'button' on 'aea6e98'.
  (fix conflicts and then run "git rebase --continue")
  (use "git rebase --skip" to skip this patch)
  (use "git rebase --abort" to check out the original branch)

Unmerged paths:
  (use "git restore --staged <file>..." to unstage)
  (use "git add <file>..." to mark resolution)
	both modified: GitBlink.ino

no changes added to commit (use "git add" and/or "git commit -a")

```

Обратите внимание, что Git предлагает несколько вариантов на выбор, что делать.

В нашем случае мы разрешили конфликты, код работает, поэтому мы можем выполнить фиксацию и дать Git продолжить(завершить) rebase.  
Мы используем нашу старую знакомую команду:

```arduino
git commit -am "rebase to BWoD code"

```

а потом

```arduino
git rebase --continue

```

 ![git6](https://forum.arduino.ru/uploads/default/original/2X/6/6a43df8fff9447dfbd7989dc0a565482ae88aae9.png)

Ветка `button` перемещена и изменения, касающиеся смены delay() на millis() в ней учтены. У нас снова чистое дерево Git и мы можем либо продолжить разработку, добавив какие-то новые функции, либо занятся чем-то другим 🙂

---

<div class="post-metadata">

**Author:** ![b707](https://forum.arduino.ru/user_avatar/forum.arduino.ru/b707/32/354_2.png) [@b707](https://forum.arduino.ru/u/b707)\
**Post date:** [27.Март.2024 14:29:12 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/12 "2024-03-27T14:29:12Z")

</div>

## Приложение А: Что такое индексация изменений (stage changes) и зачем оно нужно

перевод из StackOverflow

### Вопрос

Я только осваиваю системы контроля версий. Я понимаю, что «фиксация»(коммит) — это, по сути, создание резервной копии при обновлении новой «текущей» версии проекта.

Чего я не понимаю, так это того, что такое **staging** с практической точки зрения. Является ли **staging** чем-то, что существует только номинально, например по традиции, или оно служит какой-то цели? Когда вы совершаете коммит, он все равно будет учитывать все, верно?

### Ответ

Когда вы выполняете коммит, он фиксирует только изменения в индексе («staged» файлы). У этого есть множество применений, но наиболее очевидным является разбиение рабочих изменений на более мелкие, автономные части.  
Допустим, при работе над кодом новой функции в файле `function.cpp` вы заметили ошибку в основном коде в `main.cpp`. Вы можете зафиксировать только это исправление, попросив git добавить в индекс только этот файл (или даже добавить только часть файла опцией `git add -p` (b707 - не спрашивайте что это, не слышал о таком :)), а когда закончите редактировать функцию - зафиксировать добавления отдельным коммитом.  
Теперь, если с функцией что-то пойдет не так - вы сможете отменить ее добавление, не отменяя исправление бага в `main.cpp`, который вы исправили отдельным коммитом.  
Если вы используете git commit -a, вы просто принудительно добавляете все прямо перед фиксацией.

Вы также можете использовать staged файлы как промежуточную рабочую копию с помощью опции --cached для многих команд. Например, `git diff --cached` покажет вам, чем staged changes отличаются от HEAD(последнего сделанного коммита), чтобы вы могли видеть, что вы собираетесь зафиксировать, не смешивая это с другими изменениями в проекте.

b707 - небольшое добавление  
Точно также как в программировании существуют “правила хорошего тона” при написании программ - например использовать “говорящие” имена переменных и не использовать “магичесие числа” - в Git тоже есть свод таких правил. Одно из них гласит, что каждая фиксация должна содержать только правки, связанные общей логикой. Например, добавление нового метода - одна правка, устранение бага - другая, удаление комментов третья. Думаю что ответ выше обьясняет, зачем это нужно.

---

<div class="post-metadata">

**Author:** ![mixail844](https://forum.arduino.ru/letter_avatar_proxy/v4/letter/m/94ad74/32.png) [@mixail844](https://forum.arduino.ru/u/mixail844)\
**Post date:** [28.Март.2024 08:38:04 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/13 "2024-03-28T08:38:04Z")

</div>

классное руководсво, но я неоднократно слышал в руководствак что использовать **rebase** плохая практика и ее лучше избегать.  
так же могу порекомендовать сайт по практике гита : [https://learngitbranching.js.org/](https://learngitbranching.js.org/) (англ)

---

<div class="post-metadata">

**Author:** ![b707](https://forum.arduino.ru/user_avatar/forum.arduino.ru/b707/32/354_2.png) [@b707](https://forum.arduino.ru/u/b707)\
**Post date:** [28.Март.2024 08:46:14 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/14 "2024-03-28T08:46:14Z")

</div>

> [@mixail844](#):
>
> использовать **rebase** плохая практика и ее лучше избегать.

Вероятно да. Но слова из песни не выкинешь, автор зачем-то счел необходимым обьяснить разрешение конфликтов именно на примере rebase

---

<div class="post-metadata">

**Author:** ![ua6em](https://forum.arduino.ru/user_avatar/forum.arduino.ru/ua6em/32/325_2.png) [@ua6em](https://forum.arduino.ru/u/ua6em)\
**Post date:** [28.Март.2024 08:52:30 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/15 "2024-03-28T08:52:30Z")

</div>

> [@mixail844](#):
>
> : [https://learngitbranching.js.org/](http://out.arduino.ru/?redirect=https%3A%2F%2Flearngitbranching.js.org%2F&baseU=https%3A%2F%2Fforum.arduino.ru%2F) (англ)

у меня на русском

 ![git-1](https://forum.arduino.ru/uploads/default/original/2X/d/d81bdeaf9426040ab6eae81913f89eb6d7460b0b.png)

---

<div class="post-metadata">

**Author:** ![ua6em](https://forum.arduino.ru/user_avatar/forum.arduino.ru/ua6em/32/325_2.png) [@ua6em](https://forum.arduino.ru/u/ua6em)\
**Post date:** [10.Ноябрь.2024 15:03:18 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/16 "2024-11-10T15:03:18Z")

</div>

С [https://gitflic.ru](https://gitflic.ru) пока засада, хранить проекты можно, а вот работа командой как-то пока не задалась, разлезается архив ни pull ни push не срабатывает, но я борюсь с этим!!!

---

<div class="post-metadata">

**Author:** ![kakaider](https://forum.arduino.ru/letter_avatar_proxy/v4/letter/k/e47774/32.png) [@kakaider](https://forum.arduino.ru/u/kakaider)\
**Post date:** [10.Ноябрь.2024 15:07:24 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/17 "2024-11-10T15:07:24Z")

</div>

по getflic вопросы можно задавать тут [Telegram: Contact @gitflic\_chat](https://t.me/gitflic_chat)

---

<div class="post-metadata">

**Author:** ![BOOM](https://forum.arduino.ru/user_avatar/forum.arduino.ru/boom/32/349_2.png) [@BOOM](https://forum.arduino.ru/u/BOOM)\
**Post date:** [28.Сентябрь.2026 10:51:37 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/18 "2026-09-28T10:51:37Z")

</div>

Не знаю можно ли тут вопросы задавать - Не нашел тему для вопросов.  
Вопрос по “Слиянию мелких коммитов в один”.

 ![изображение](https://forum.arduino.ru/uploads/default/original/3X/8/5/8515e573e814072ae1d76857315aa2cc9aa1587b.png)

Допустим я хочу объединить мелкие правки воедино. Для примера у меня это “Ветка test(х)” (1-3).  
Я кликаю правой клавишей и выбираю “Перемещение потомков … интерактивно…”.

 ![изображение](https://forum.arduino.ru/uploads/default/original/3X/3/a/3a91b8b7dd78a24210b8180a2572eb74e2d293ca.png)

А там можно и объединить.

Вроде бы всё и хорошо, но… Это всё работает пока всё локально, а если я ветку отправил на удаленный git-сервер, то всё ломается.

При попытке отправить ветку после объединения коммитов на сервер получаю ошибку. Если отправляю принудительно - получаю херню (может руки кривые?).

Как тут быть? Не отправлять рабочую ветку на удаленный сервер? Или можно как-то это разрешить?

---

<div class="post-metadata">

**Author:** ![v258](https://forum.arduino.ru/user_avatar/forum.arduino.ru/v258/32/326_2.png) [@v258](https://forum.arduino.ru/u/v258)\
**Post date:** [28.Сентябрь.2026 12:58:40 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/19 "2026-09-28T12:58:40Z")

</div>

> [@BOOM](#):
>
> Как тут быть?

Не сливать мелкие коммиты ))

---

<div class="post-metadata">

**Author:** ![Ljubitel](https://forum.arduino.ru/user_avatar/forum.arduino.ru/ljubitel/32/20705_2.png) [@Ljubitel](https://forum.arduino.ru/u/Ljubitel)\
**Post date:** [28.Сентябрь.2026 13:43:35 UTC](https://forum.arduino.ru/t/ispolzuem-git/13564/20 "2026-09-28T13:43:35Z")

</div>

git push --force-with-lease origin test

–force-with-lease заменит опубликованную историю, только если ветка на сервере не изменилась

[Следующая страница](https://forum.arduino.ru/t/ispolzuem-git/13564.md?page=2)
