Git и GitHub: полное руководство по эффективной работе с версиями

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

Важность системы контроля версий

Система контроля версий (VCS) является фундаментальным инструментом современной разработки. Git предоставляет:

• Отслеживание изменений в коде
• Возможность отката к предыдущим версиям
• Параллельную разработку в команде
• Резервное копирование кода
• Аудит изменений и ответственности

Основы Git

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

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

# Клонирование существующего репозитория
git clone https://github.com/username/repository.git

# Клонирование с указанием папки
git clone https://github.com/username/repository.git my-project

Базовые команды

# Проверка статуса
git status

# Добавление файлов в staging area
git add filename.js
git add .  # Добавить все файлы

# Создание коммита
git commit -m "Add user authentication feature"

# Просмотр истории коммитов
git log
git log --oneline
git log --graph --oneline --all

Настройка Git

# Настройка пользователя
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

# Настройка редактора
git config --global core.editor "code --wait"

# Настройка ветки по умолчанию
git config --global init.defaultBranch main

# Просмотр конфигурации
git config --list

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

Создание и переключение веток

# Создание новой ветки
git branch feature/user-auth

# Переключение на ветку
git checkout feature/user-auth

# Создание и переключение одной командой
git checkout -b feature/user-auth

# Просмотр всех веток
git branch -a

# Удаление ветки
git branch -d feature/user-auth
git branch -D feature/user-auth  # Принудительное удаление

Современный Git (Git 2.23+)

# Новые команды для работы с ветками
git switch feature/user-auth
git switch -c feature/user-auth

# Восстановление файлов
git restore filename.js
git restore --staged filename.js

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

# Слияние ветки в текущую
git merge feature/user-auth

# Слияние с отменой fast-forward
git merge --no-ff feature/user-auth

# Слияние с squash (объединение коммитов)
git merge --squash feature/user-auth
git commit -m "Merge feature/user-auth"

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

Настройка remote

# Добавление удаленного репозитория
git remote add origin https://github.com/username/repository.git

# Просмотр удаленных репозиториев
git remote -v

# Изменение URL удаленного репозитория
git remote set-url origin https://github.com/username/new-repository.git

# Удаление remote
git remote remove origin

Синхронизация с удаленным репозиторием

# Получение изменений
git fetch origin
git fetch origin main

# Получение и слияние изменений
git pull origin main
git pull --rebase origin main

# Отправка изменений
git push origin main
git push -u origin main  # Установка upstream

# Принудительная отправка (осторожно!)
git push --force-with-lease origin main

Эффективные коммиты

Структура коммитов

# Conventional Commits
git commit -m "feat: add user authentication"
git commit -m "fix: resolve login validation issue"
git commit -m "docs: update README with installation steps"
git commit -m "style: format code according to style guide"
git commit -m "refactor: simplify authentication logic"
git commit -m "test: add unit tests for user service"
git commit -m "chore: update dependencies"

Типы коммитов

• feat: новая функциональность
• fix: исправление багов
• docs: изменения в документации
• style: форматирование кода
• refactor: рефакторинг кода
• test: добавление тестов
• chore: обновление зависимостей, конфигурации

Интерактивный rebase

# Редактирование последних коммитов
git rebase -i HEAD~3

# Команды в интерактивном режиме:
# pick - использовать коммит как есть
# reword - изменить сообщение коммита
# edit - остановиться для редактирования
# squash - объединить с предыдущим коммитом
# fixup - объединить, но удалить сообщение
# drop - удалить коммит

GitHub Workflow

Создание Pull Request

# 1. Создание feature ветки
git checkout -b feature/new-feature

# 2. Внесение изменений
# ... редактирование файлов ...

# 3. Коммит изменений
git add .
git commit -m "feat: implement new feature"

# 4. Отправка ветки
git push origin feature/new-feature

# 5. Создание Pull Request на GitHub

Шаблон Pull Request

## Описание
Краткое описание изменений

## Тип изменений
- [ ] Bug fix
- [ ] New feature
- [ ] Breaking change
- [ ] Documentation update

## Тестирование
- [ ] Unit tests добавлены/обновлены
- [ ] Manual testing выполнен
- [ ] All tests pass

## Чек-лист
- [ ] Код соответствует style guide
- [ ] Документация обновлена
- [ ] Коммиты следуют conventional commits
- [ ] Self-review выполнен

## Скриншоты (если применимо)

Code Review

# Просмотр изменений в PR
git fetch origin pull/123/head:pr-123
git checkout pr-123

# Добавление комментариев к конкретным строкам
# В GitHub интерфейсе: клик на номер строки

# Запрос изменений
# В GitHub: Request changes

# Одобрение изменений
# В GitHub: Approve

Продвинутые техники

Stash

# Сохранение изменений во временное хранилище
git stash
git stash push -m "WIP: working on feature"

# Просмотр stash
git stash list

# Применение stash
git stash pop
git stash apply stash@{0}

# Удаление stash
git stash drop stash@{0}
git stash clear

Cherry-pick

# Применение конкретного коммита
git cherry-pick abc1234

# Применение диапазона коммитов
git cherry-pick abc1234..def5678

# Cherry-pick с продолжением
git cherry-pick --continue
git cherry-pick --abort

Rebase

# Rebase текущей ветки на main
git rebase main

# Интерактивный rebase
git rebase -i HEAD~5

# Rebase с продолжением
git rebase --continue
git rebase --abort
git rebase --skip

Bisect

# Поиск коммита, который ввел баг
git bisect start
git bisect bad HEAD
git bisect good abc1234

# После тестирования
git bisect good  # или git bisect bad

# Завершение bisect
git bisect reset

Git Hooks

Pre-commit Hook

#!/bin/sh
# .git/hooks/pre-commit

# Запуск линтера
npm run lint

# Запуск тестов
npm test

# Проверка типов (TypeScript)
npm run type-check

Commit-msg Hook

#!/bin/sh
# .git/hooks/commit-msg

# Проверка conventional commits
commit_regex='^(feat|fix|docs|style|refactor|test|chore)(\(.+\))?: .{1,50}'

if ! grep -qE "$commit_regex" "$1"; then
    echo "Error: Commit message does not follow conventional commits format"
    exit 1
fi

Husky для автоматизации

// package.json
{
  "husky": {
    "hooks": {
      "pre-commit": "lint-staged",
      "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
    }
  },
  "lint-staged": {
    "*.{js,jsx,ts,tsx}": [
      "eslint --fix",
      "prettier --write"
    ]
  }
}

GitHub Actions

CI/CD Pipeline

# .github/workflows/ci.yml
name: CI/CD Pipeline

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest
    
    steps:
    - uses: actions/checkout@v3
    
    - name: Setup Node.js
      uses: actions/setup-node@v3
      with:
        node-version: '18'
        cache: 'npm'
    
    - name: Install dependencies
      run: npm ci
    
    - name: Run linter
      run: npm run lint
    
    - name: Run tests
      run: npm test
    
    - name: Build project
      run: npm run build

Deploy на GitHub Pages

# .github/workflows/deploy.yml
name: Deploy to GitHub Pages

on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    
    steps:
    - uses: actions/checkout@v3
    
    - name: Setup Node.js
      uses: actions/setup-node@v3
      with:
        node-version: '18'
    
    - name: Install dependencies
      run: npm ci
    
    - name: Build project
      run: npm run build
    
    - name: Deploy to GitHub Pages
      uses: peaceiris/actions-gh-pages@v3
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: ./dist

Лучшие практики

1. Структура коммитов

• Используйте conventional commits
• Пишите понятные сообщения
• Делайте атомарные коммиты
• Избегайте коммитов "WIP"

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

• Используйте feature branches
• Называйте ветки понятно
• Удаляйте мертвые ветки
• Используйте защищенные ветки

3. Pull Requests

• Создавайте небольшие PR
• Добавляйте описания
• Используйте шаблоны
• Требуйте code review

4. Безопасность

• Не коммитьте секреты
• Используйте .gitignore
• Проверяйте зависимости
• Обновляйте регулярно

5. Командная работа

• Согласуйте workflow
• Используйте единые стандарты
• Проводите code review
• Документируйте процессы

Troubleshooting

Отмена последнего коммита

# Отмена коммита, сохранение изменений
git reset --soft HEAD~1

# Отмена коммита, удаление изменений
git reset --hard HEAD~1

# Создание нового коммита для отмены
git revert HEAD

Восстановление удаленных файлов

# Восстановление файла из последнего коммита
git checkout HEAD -- filename.js

# Восстановление из конкретного коммита
git checkout abc1234 -- filename.js

# Восстановление удаленной ветки
git reflog
git checkout -b recovered-branch abc1234

Разрешение конфликтов

# Просмотр конфликтующих файлов
git status

# Редактирование файлов с конфликтами
# ... разрешение конфликтов вручную ...

# Добавление разрешенных файлов
git add filename.js

# Продолжение операции
git commit  # для merge
git rebase --continue  # для rebase

Заключение

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

Ключевые моменты для запоминания:

1. Изучите основы Git - команды, ветки, коммиты
2. Используйте conventional commits для понятной истории
3. Работайте с ветками эффективно
4. Проводите code review для качества кода
5. Автоматизируйте процессы с помощью hooks и CI/CD
6. Следуйте лучшим практикам для командной работы

Следуя этим рекомендациям, вы сможете создать эффективный workflow для разработки, который будет масштабироваться с ростом проекта и команды.