Git и GitHub в Android Studio: настройка и работа с репозиторием

Android Studio поддерживает Git и GitHub из коробки: настройте локальный Git, добавьте Personal Access Token и вы сможете клонировать репозитории, коммитить, пушить и управлять ветками прямо из IDE.

Быстрая настройка Git и подключение GitHub

  1. Установите Git и укажите путь в Android Studio: File > Settings > Version Control > Git — нажмите Test (зеленая галочка).
  2. Настройте имя и email (в терминале IDE):
    git config --global user.name "Ваше Имя"
    git config --global user.email "you@example.com"
  3. Подключите аккаунт GitHub: File > Settings > Version Control > GitHub > + > Log In with Token. Создайте на GitHub Personal access token с правами repo (и workflow по необходимости). Вставьте токен — Android Studio запомнит его.

Используйте Personal access token вместо пароля — это безопаснее и часто обязательно с двухфакторной аутентификацией.

Основные операции: клонирование, коммит, пуш, пулл и ветки

  • Клонирование: File > New > Project from Version Control, введите URL (https://github.com/username/repo.git), укажите локальную папку и ветку. IDE автоматически откроет проект и настроит VCS.
  • Коммит: правка файлов → Version Control (Local Changes) → выделите файлы → Add to VCS (Ctrl+Alt+A) → Commit (Ctrl+K). Пишите понятные сообщения.
  • Пуш: после коммита VCS > Git > Push (Ctrl+Shift+K). Выберите remote (обычно origin) и ветку.
  • Пулл: VCS > Git > Pull (Ctrl+T). Можно выбрать merge или rebase.
  • Ветвление: VCS > Git > New Branch, даёте имя (feature/login). Переключение и управление ветками через меню Git Branches внизу справа.

Практический чеклист:

  • Перед созданием PR всегда обновите main: pull → создать ветку → работать → push ветки → открыть PR.
  • Пишите короткие сообщения коммитов и группируйте логически связанные правки.

Не используйте force push в командных ветках — это удаляет историю и может сломать чужую работу.

Разрешение конфликтов и полезные инструменты

  • Конфликты: Android Studio покажет файлы с конфликтами в Version Control > Incoming/Outgoing. Нажмите Merge — откроется визуальный мёрдж-редактор, где можно выбрать изменения левой/правой стороны или объединить вручную.
  • Stash: VCS > Git > Stash Changes — временно убирает незаконченные правки.
  • Git Log: VCS > Git > Show History — удобный граф коммитов и поиск.
  • Blame: правый клик по строке → Git → Show Blame — кто и когда изменял код.
  • Защитите main на GitHub: включите правило Protected branches и требуйте PR и проверок перед merge (делается в настройках GitHub).

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

  • "Git not found": проверьте путь к исполняемому файлу Git в настройках IDE.
  • Authentication failed: токен устарел или недостаточно прав — пересоздайте token и вставьте заново.
  • Push rejected: сначала выполните pull и решите конфликты; только в личных репозиториях можно использовать force push.
  • Проект не открывается после клонирования: проверьте наличие файла settings.gradle/settings.gradle.kts и корректность настроек Gradle.

FAQ

  • Как создать первый коммит в пустом репозитории?
    Создайте README.md, Add to VCS → Commit → Push. Это инициализирует репозиторий на удалённом сервере, если он пустой.
  • Нужно ли учить команды Git в CLI, если я пользуюсь Android Studio?
    Да — базовые команды (clone, commit, push, pull, checkout, rebase) полезны для дебага и сценариев вне IDE.
  • Как откатить последний коммит?
    Если коммит не запушен: VCS > Git > Reset HEAD... (choose Soft/Hard). Если запушен — используйте revert через Git Log.

С этой настройкой вы получите удобный рабочий процесс: клонирование, ветвление, визуальное разрешение конфликтов и безопасный пуш — всё без лишних переключений между инструментами.