Инструкция по работе с Git и GitHub

Содержание

1. Введение
2. Создание учетной записи GitHub
3. Установка Git
4. Первоначальная настройка Git
5. Создание локального репозитория
6. Основные команды локального Git
7. Работа с ветками
8. Работа с удаленным репозиторием
9. Работа с форками
10. Слияние веток
11. Порядок выполнения практической работы
12. Частые ошибки
13. Краткая таблица команд
14. Вывод

---

1. Введение

Git — это распределенная система контроля версий. Она используется для сохранения истории изменений проекта, работы с разными версиями файлов и организации совместной разработки.

Git позволяет:

• сохранять изменения в виде коммитов;
• просматривать историю проекта;
• создавать отдельные ветки для разных задач;
• объединять изменения из разных веток;
• возвращаться к предыдущим версиям проекта;
• работать с удаленными репозиториями.

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

Главное различие между Git и GitHub:

Инструмент	Назначение
Git	Программа для контроля версий на компьютере
GitHub	Онлайн-платформа для хранения Git-репозиториев

В данной практической работе необходимо разработать инструкцию по работе с Git, оформить ее в формате Markdown, создать несколько веток и объединить их в основную ветку.

---

2. Создание учетной записи GitHub

Для работы с удаленными репозиториями необходимо создать учетную запись GitHub.

Порядок регистрации

1. Открыть сайт GitHub.
2. Нажать кнопку Sign up.
3. Ввести адрес электронной почты.
4. Создать пароль.
5. Указать имя пользователя.
6. Подтвердить регистрацию через электронную почту.
7. Войти в созданный аккаунт.

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

Создание нового репозитория

Для создания репозитория необходимо:

1. Нажать кнопку New repository.
2. Ввести имя репозитория, например:

git-instruction

3. Выбрать тип репозитория:

Тип	Описание
Public	Репозиторий доступен всем пользователям
Private	Репозиторий доступен только владельцу и приглашенным пользователям

4. Нажать кнопку Create repository.

После создания GitHub покажет ссылку на репозиторий. Она понадобится для подключения локального проекта к удаленному репозиторию.

Пример ссылки:

https://github.com/username/git-instruction.git

---

3. Установка Git

Перед началом работы необходимо установить Git на компьютер.

Установка Git на Windows

Для установки Git на Windows необходимо:

1. Скачать установщик Git.
2. Запустить установочный файл.
3. Оставить стандартные настройки установки.
4. Завершить установку.
5. Открыть программу Git Bash.
6. Проверить установленную версию Git.

Команда для проверки версии:

git --version

Пример результата:

git version 2.45.0

Если версия отображается, значит Git установлен правильно.

Установка Git на Linux

Для установки Git в Debian или Ubuntu используется команда:

sudo apt update
sudo apt install git

Проверка версии:

git --version

Пример результата:

git version 2.43.0

---

4. Первоначальная настройка Git

После установки Git необходимо указать имя пользователя и адрес электронной почты. Эти данные будут записываться в историю коммитов.

Настройка имени пользователя

git config --global user.name "Student"

Пример:

git config --global user.name "Ivan Ivanov"

Настройка электронной почты

git config --global user.email "student@mail.com"

Пример:

git config --global user.email "ivanov@mail.com"

Проверка настроек Git

git config --list

Пример результата:

user.name=Student
user.email=student@mail.com

Команда git config --list показывает текущие настройки Git.

---

<<<<<<< HEAD

5. Создание локального репозитория

Локальный репозиторий — это репозиторий, который хранится на компьютере пользователя. В нем находятся файлы проекта и служебная папка .git, где Git хранит историю изменений.

Создание папки проекта

mkdir git-instruction
=======
## 8. Работа с удаленным репозиторием

Удаленный репозиторий — это репозиторий, который хранится на сервере, например на GitHub.

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

### Добавление удаленного репозитория

```bash
git remote add origin https://github.com/username/git-instruction.git
>>>>>>> global

Пример:

<<<<<<< HEAD
mkdir my-project

Команда mkdir создает новую папку.

Переход в папку проекта

cd git-instruction

Пример:

cd my-project

Команда cd используется для перехода в нужную папку.

Инициализация Git-репозитория

git init
=======
git remote add origin https://github.com/student/git-instruction.git

Здесь:

• origin — стандартное имя удаленного репозитория;
• ссылка — адрес репозитория на GitHub.

Проверка подключенного удаленного репозитория

git remote -v
>>>>>>> global

Пример результата:

<<<<<<< HEAD
Initialized empty Git repository in C:/Users/User/git-instruction/.git/

Команда git init создает локальный Git-репозиторий. После выполнения команды в папке проекта появляется скрытая папка .git.

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

git status

Пример результата:

On branch main

No commits yet

nothing to commit

Команда git status показывает текущее состояние репозитория: текущую ветку, измененные файлы и файлы, подготовленные к коммиту.

---

6. Основные команды локального Git

Локальная работа с Git включает создание файлов, добавление их в индекс, создание коммитов и просмотр истории изменений.

Создание файла README.md

echo "# Инструкция по Git" > README.md
=======
origin  https://github.com/student/git-instruction.git (fetch)
origin  https://github.com/student/git-instruction.git (push)

Команда показывает список удаленных репозиториев.

Отправка основной ветки на GitHub

git push -u origin main
>>>>>>> global

Пример:

<<<<<<< HEAD
echo "# Мой проект" > README.md

Команда создает файл README.md и записывает в него заголовок.

Добавление файла в индекс

git add README.md

Пример:

git add README.md

Команда git add добавляет файл в индекс. Индекс — это промежуточная область, куда помещаются изменения перед сохранением в коммит.

Добавление всех файлов

git add .

Пример:

git add .

Команда git add . добавляет в индекс все измененные и новые файлы в текущей папке проекта.

Создание коммита

git commit -m "Создан файл README.md"

Пример:

git commit -m "Добавлена основная структура инструкции"

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

Просмотр истории коммитов

git log

Пример результата:

commit a1b2c3d4
Author: Student <student@mail.com>
Date:   Mon May 13 12:00:00 2026 +0300

    Создан файл README.md

Команда git log показывает полную историю коммитов.

Краткий просмотр истории

git log --oneline

Пример результата:

a1b2c3d Создан файл README.md

Команда git log --oneline показывает историю коммитов в кратком виде.

Просмотр изменений в файлах

git diff

Пример:

git diff README.md

Команда git diff показывает изменения, которые еще не были добавлены в индекс.

Отмена изменений в файле

git checkout -- README.md

Пример:

git checkout -- README.md

Команда отменяет несохраненные изменения в указанном файле.

---

7. Работа с ветками

Ветка — это отдельная линия разработки проекта. Ветки позволяют работать над разными частями проекта независимо друг от друга.

В практической работе необходимо использовать три ветки:

Ветка	Назначение
main или master	Основная ветка, структура документа, создание GitHub-аккаунта и установка Git
local	Описание команд для работы с локальным Git
global	Описание работы с удаленным Git и форками

Просмотр веток

git branch

Пример результата:

* main

Знак * показывает текущую активную ветку.

Создание ветки local

git branch local

Пример:

git branch local

Команда создает новую ветку local.

Переход в ветку local

git checkout local

Пример результата:

Switched to branch 'local'

Создание ветки и переход в нее одной командой

git checkout -b global

Пример результата:

Switched to a new branch 'global'

Команда git checkout -b одновременно создает новую ветку и переключается на нее.

Возврат в основную ветку

git checkout main

Пример:

git checkout main
=======
git push -u origin main

Параметр -u связывает локальную ветку с удаленной. После этого для следующих отправок можно использовать просто:

git push
>>>>>>> global

Если основная ветка называется master, используется команда:

<<<<<<< HEAD
git checkout master

Просмотр всех веток

git branch
=======
git push -u origin master

Отправка ветки local

git checkout local
git push -u origin local

Пример:

git checkout local
git push -u origin local

Отправка ветки global

git checkout global
git push -u origin global

Пример:

git checkout global
git push -u origin global

Получение изменений из удаленного репозитория

git pull

Пример:

git pull origin main

Команда git pull загружает изменения из удаленного репозитория и объединяет их с текущей веткой.

Загрузка изменений без автоматического слияния

git fetch

Пример:

git fetch origin

Команда git fetch загружает информацию об изменениях из удаленного репозитория, но не объединяет их автоматически с текущими файлами.

Клонирование репозитория

git clone https://github.com/username/git-instruction.git

Пример:

git clone https://github.com/student/git-instruction.git

Команда git clone скачивает удаленный репозиторий на компьютер.

---

9. Работа с форками

Форк — это копия чужого репозитория, созданная в своем аккаунте GitHub. Форки используются для внесения изменений в чужой проект без прямого доступа к оригинальному репозиторию.

Для чего нужен форк

Форк позволяет:

• скопировать чужой проект в свой аккаунт;
• внести изменения в своей копии;
• отправить предложение изменений автору оригинального проекта;
• безопасно работать с проектом, не изменяя исходный репозиторий.

Создание форка

Для создания форка необходимо:

1. Открыть чужой репозиторий на GitHub.
2. Нажать кнопку Fork.
3. Выбрать свой аккаунт.
4. Дождаться создания копии репозитория.

После этого в аккаунте появится копия проекта.

Клонирование форка

git clone https://github.com/username/project.git

Пример:

git clone https://github.com/student/example-project.git

Переход в папку проекта

cd example-project

Пример:

cd example-project

Добавление оригинального репозитория

Оригинальный репозиторий обычно добавляют под именем upstream.

git remote add upstream https://github.com/original-author/project.git

Пример:

git remote add upstream https://github.com/original/example-project.git

Проверка удаленных репозиториев

git remote -v
>>>>>>> global

Пример результата:

<<<<<<< HEAD
  global
  local
* main

В данном примере текущей активной веткой является main.

origin https://github.com/student/example-project.git (fetch) origin https://github.com/student/example-project.git (push) upstream https://github.com/original/example-project.git (fetch) upstream https://github.com/original/example-project.git (push)

Здесь:

- `origin` — личная копия репозитория;
- `upstream` — оригинальный репозиторий.

### Получение изменений из оригинального репозитория

```bash
git fetch upstream

Пример:

git fetch upstream

Обновление своей ветки main

git checkout main
git merge upstream/main

Пример:

git checkout main
git merge upstream/main

Эти команды позволяют обновить свою копию проекта изменениями из оригинального репозитория.

Создание Pull Request

После внесения изменений в форк их можно предложить автору оригинального проекта.

Общий порядок:

1. Внести изменения в своей копии проекта.
2. Создать коммит.
3. Отправить изменения в свой репозиторий.
4. Открыть GitHub.
5. Нажать кнопку Compare & pull request.
6. Описать изменения.
7. Отправить Pull Request.

Пример команд:

git add .
git commit -m "Исправлена документация"
git push origin main

После этого изменения будут доступны в форке на GitHub.

global

---

10. Слияние веток

По заданию итоговый вариант работы должен быть результатом слияния всех веток в основную ветку main или master.

В данной работе используются ветки:

main
local
global

Ветка main содержит основную структуру документа, описание создания учетной записи GitHub и установку Git.

Ветка local содержит описание команд для локальной работы с Git.

Ветка global содержит описание работы с удаленным репозиторием и форками.

Переход в основную ветку

git checkout main

Пример:

git checkout main

Слияние ветки local

git merge local

Пример результата:

Updating a1b2c3d..d4e5f6g
Fast-forward
 README.md | 50 +++++++++++++++++++++++++++++++++

После выполнения команды изменения из ветки local попадают в основную ветку.

Слияние ветки global

git merge global

Пример:

git merge global

После выполнения команды изменения из ветки global также попадают в основную ветку.

Проверка истории после слияния

git log --oneline --graph --all

Пример результата:

*   9f8e7d6 Merge branch 'global'
|\
| * 7a6b5c4 Добавлено описание удаленного Git и форков
* |   5d4c3b2 Merge branch 'local'
|\ \
| * | 3c2b1a0 Добавлены команды локального Git
| |/
* / 1a2b3c4 Создана структура документа

Команда показывает историю коммитов в виде графа.

---

11. Порядок выполнения практической работы

Ниже приведен общий порядок выполнения практической работы.

Шаг 1. Создание папки проекта

mkdir git-instruction
cd git-instruction

Шаг 2. Инициализация Git-репозитория

git init

Шаг 3. Создание файла README.md

echo "# Инструкция по работе с Git и GitHub" > README.md

Шаг 4. Добавление файла в индекс

git add README.md

Шаг 5. Создание первого коммита

git commit -m "main: создана структура README, описаны GitHub и установка Git"

Шаг 6. Создание ветки local

git checkout -b local

В ветке local были добавлены разделы, связанные с локальной работой Git.

После внесения изменений был выполнен коммит:

git add README.md
git commit -m "local: добавлены команды локального Git"

Шаг 7. Создание ветки global

Сначала был выполнен возврат в основную ветку:

git checkout main

Затем была создана ветка global:

git checkout -b global

В ветке global были добавлены разделы, связанные с удаленным репозиторием и форками.

После внесения изменений был выполнен коммит:

git add README.md
git commit -m "global: добавлена работа с удаленным Git и форками"

Шаг 8. Слияние веток

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

git checkout main

Затем были объединены ветки local и global:

git merge local
git merge global

Шаг 9. Проверка истории

git log --oneline --graph --all

Шаг 10. Подключение удаленного репозитория

git remote add origin https://github.com/username/git-instruction.git

Пример:

git remote add origin https://github.com/student/git-instruction.git

Шаг 11. Отправка результата на GitHub

git push -u origin main

Если основная ветка называется master, используется команда:

git push -u origin master

Шаг 12. Отправка дополнительных веток

git push -u origin local
git push -u origin global

В результате на удаленном репозитории GitHub находятся все созданные ветки и итоговый вариант работы в ветке main.

---

12. Частые ошибки

Ошибка: pathspec 'main' did not match any file

Пример ошибки:

error: pathspec 'main' did not match any file(s) known to git

Причина ошибки: ветка main не существует. Возможно, основная ветка называется master.

Проверить список веток можно командой:

git branch

Если существует ветка master, нужно перейти в нее:

git checkout master

Ошибка: nothing to commit

Пример:

nothing to commit, working tree clean

Это означает, что в проекте нет новых изменений для сохранения.

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

git status

Ошибка: remote origin already exists

Пример:

error: remote origin already exists

Причина ошибки: удаленный репозиторий origin уже добавлен.

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

git remote -v

Если нужно заменить ссылку, используется команда:

git remote set-url origin https://github.com/username/new-repository.git

Пример:

git remote set-url origin https://github.com/student/git-instruction.git

Ошибка при слиянии веток

Пример:

CONFLICT (content): Merge conflict in README.md

Такая ошибка возникает, если в разных ветках были изменены одни и те же строки файла.

Для исправления необходимо:

1. Открыть файл с конфликтом.
2. Найти конфликтующие строки.
3. Вручную оставить правильный вариант.
4. Сохранить файл.
5. Добавить исправленный файл в индекс:

git add README.md

6. Создать коммит:

git commit -m "Исправлен конфликт слияния"

---

13. Краткая таблица команд

Команда	Назначение	Пример
git --version	Проверить версию Git	git --version
git config --global user.name	Задать имя пользователя	git config --global user.name "Student"
git config --global user.email	Задать почту пользователя	git config --global user.email "student@mail.com"
git config --list	Посмотреть настройки Git	git config --list
git init	Создать локальный репозиторий	git init
git status	Проверить состояние репозитория	git status
git add README.md	Добавить файл в индекс	git add README.md
git add .	Добавить все изменения	git add .
git commit -m	Создать коммит	git commit -m "Первый коммит"
git log	Посмотреть историю коммитов	git log
git log --oneline	Посмотреть краткую историю	git log --oneline
git branch	Посмотреть ветки	git branch
git branch local	Создать ветку	git branch local
git checkout local	Перейти в ветку	git checkout local
git checkout -b global	Создать ветку и перейти в нее	git checkout -b global
git merge local	Слить ветку с текущей	git merge local
git remote add origin	Добавить удаленный репозиторий	git remote add origin ссылка
git remote -v	Посмотреть удаленные репозитории	git remote -v
git push	Отправить изменения на GitHub	git push origin main
git pull	Получить изменения с GitHub	git pull origin main
git fetch	Получить изменения без слияния	git fetch origin
git clone	Скачать репозиторий	git clone ссылка

---

14. Вывод

В ходе выполнения практической работы была разработана инструкция по работе с Git и GitHub. Инструкция оформлена в формате Markdown и содержит описание основных команд Git с примерами их использования.

Были рассмотрены этапы создания учетной записи GitHub, установки Git, первоначальной настройки пользователя, создания локального репозитория, работы с файлами, коммитами и историей изменений.

Также была описана работа с ветками. Для выполнения задания использовались ветки main, local и global. Ветка main содержала основную структуру документа, описание создания учетной записи GitHub и установку Git. Ветка local использовалась для описания команд локального Git. Ветка global использовалась для описания работы с удаленным репозиторием и форками.

Итоговый вариант работы был получен путем слияния веток local и global в основную ветку main. После этого результат был отправлен на удаленный репозиторий GitHub.

Таким образом, в ходе практической работы были закреплены навыки работы с Git, ветками, коммитами, удаленными репозиториями и сервисом GitHub.