🚀 Полное руководство по Git и GitHub

💬 Личные заметки и шпаргалка по работе с системой контроля версий Git и платформой GitHub.
Полезно при разработке, обучении и ведении собственных проектов.

---

🧩 Что такое Git и зачем он нужен

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

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

---

⚙️ Основные понятия

🧠 Термин	📖 Объяснение
Репозиторий	Хранилище проекта и его истории
Коммит (commit)	Снимок текущего состояния проекта
Ветка (branch)	Отдельная линия разработки
Merge (слияние)	Объединение веток
Remote (удалённый репозиторий)	Репозиторий на сервере (например, GitHub)
HEAD	Указатель на текущий коммит
Staging area	Зона подготовки перед коммитом

---

🏗️ Инициализация проекта

mkdir my-project
cd my-project
git init

Теперь в папке появится скрытая директория .git — это база данных Git.

---

🧱 Работа с файлами и коммитами

Действие	Команда	Описание
Добавить файл	git add file.txt	Подготовить конкретный файл
Добавить всё	git add .	Добавить все изменения
Создать коммит	git commit -m "Описание"	Зафиксировать изменения
Проверить состояние	git status	Какие файлы изменены
Посмотреть историю	git log --oneline	Краткий список коммитов

---

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

git branch           # показать ветки
git branch dev       # создать новую ветку
git checkout dev     # перейти в неё
git merge dev        # объединить с основной
git branch -d dev    # удалить после слияния

💡 Основная ветка по умолчанию — main.

---

🔀 Слияние и конфликты

Если ветки расходятся, Git создаёт merge-коммит:

git merge feature

Если изменён один и тот же участок кода — появится конфликт.
Git пометит конфликтные места:

<<<<<<< HEAD
текущая версия
=======
версия из другой ветки
>>>>>>> feature

Ты решаешь вручную, что оставить, и делаешь git add + git commit.

---

☁️ Работа с GitHub

1. Создать новый репозиторий на GitHub
2. Связать локальный проект:

   git remote add origin https://github.com/username/repo.git
   git branch -M main
   git push -u origin main

3. Проверить связь:

   git remote -v

---

📥 Получение обновлений

Действие	Команда
Скачать и объединить изменения	git pull origin main
Только скачать (без merge)	git fetch origin
Посмотреть разницу	git diff

---

🔁 Полезные команды

git reset file.txt # убрать файл из индекса git reset --soft HEAD1 # отменить коммит, сохранить изменения git reset --hard HEAD1 # откатить полностью git rm file.txt # удалить файл из репозитория

---

🧭 Стандартный цикл работы

git status git add . git commit -m "описание изменений" git push origin main

---

🔐 Авторизация через SSH (по желанию)

ssh-keygen -t ed25519 -C "your_email@example.com" pbcopy < ~/.ssh/id_ed25519.pub

Добавь ключ в GitHub → Settings → SSH and GPG keys.

---

💡 Полезные советы

✅ Пиши понятные сообщения коммитов
✅ Делай git pull перед git push
✅ Используй ветки для экспериментов
✅ Добавляй .gitignore, чтобы исключить временные файлы

---

🧾 Мини-шпаргалка

git init git add . git commit -m "first commit" git branch -M main git remote add origin https://github.com/username/repo.git git push -u origin main

---

_Автор: Max — личные заметки по Git и GitHub_