Работа с GitHub
от А до Я

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

Строка поиска находится вверху любой страницы GitHub. Нажми / чтобы быстро сфокусироваться на ней.

Фильтры в строке поиска

Можно добавлять прямо к запросу через пробел:

Пример сложного запроса:

ffmpeg language:python stars:>500 pushed:>2024-01-01 fork:false

GitHub Explore

На странице github.com/explore — тренды, тематические подборки, рекомендации. Вкладка Trending (github.com/trending) — самые популярные репозитории за день/неделю/месяц.

Что где находится

Как читать README

README рендерится автоматически при открытии репо. Обычно там секции:

• Installation — как установить (pip install, npm install, cmake и т.д.)
• Quick start / Usage — минимальный рабочий пример
• Requirements — зависимости, версии ОС, рантаймы
• Contributing — как помочь проекту (для разработчиков)
• License — лицензия. MIT / Apache 2.0 = можно использовать свободно в большинстве случаев

Способ 1 — ZIP-архив (без Git)

Самый простой способ. Не требует никаких инструментов. Нет истории изменений.

1. Открой страницу репозитория
2. Нажми зелёную кнопку Code ▾ (справа над файлами)
3. В выпадающем меню выбери Download ZIP

   Файл загрузится как repo-name-main.zip — просто разархивируй

Способ 2 — git clone (рекомендуется)

Создаёт полную локальную копию репозитория с историей. Потом легко обновить одной командой.

1. Нажми Code ▾ → вкладка HTTPS → скопируй ссылку вида https://github.com/owner/repo.git
2. В терминале выполни:

   bashкопировать

   git clone https://github.com/owner/repo.git

3. Войди в созданную папку:

   bashкопировать

   cd repo

Позже, чтобы скачать обновления:

git pull

Способ 3 — Releases (готовые сборки)

Если автор публикует скомпилированные программы или пакеты — они будут в Releases. Для конечных пользователей это предпочтительный вариант.

1. На странице репо найди раздел Releases в правой колонке (или вкладка сверху)
2. Выбери последнюю стабильную версию (не помеченную как Pre-release)
3. В разделе Assets скачай нужный файл под свою платформу: windows-amd64.zip, linux-x86_64.tar.gz, macos-arm64.dmg и т.д.

Способ 4 — один файл через Raw

Нужен конкретный файл, а не весь репозиторий:

1. Открой нужный файл в репозитории (кликни по нему)
2. Нажми кнопку Raw (справа над содержимым файла) — откроется страница с чистым текстом
3. Либо Ctrl+S для сохранения, либо скопируй URL и используй curl:

curl -O https://raw.githubusercontent.com/owner/repo/main/script.py

# или wget:
wget https://raw.githubusercontent.com/owner/repo/main/script.py

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

Проверь установку:

git --version
# git version 2.47.0

Первоначальная настройка (один раз)

Укажи имя и email — они будут видны в истории коммитов:

git config --global user.name  "Иван Петров"
git config --global user.email "ivan@example.com"

Клонирование и обновление

# Клонировать репозиторий
git clone https://github.com/owner/repo.git

# Клонировать в конкретную папку
git clone https://github.com/owner/repo.git my-folder

# Быстрое клонирование без истории (только текущий срез)
git clone --depth 1 https://github.com/owner/repo.git

# Обновить локальную копию до актуального состояния
git pull

# Посмотреть изменения без их применения
git fetch

# Обновить все ветки
git fetch --all

Навигация по истории

# Краткая история коммитов
git log --oneline

# Последние 20 коммитов
git log --oneline -20

# Граф веток
git log --oneline --graph

# Список всех тегов (версий)
git tag

# Переключиться на конкретную версию
git checkout v2.1.0

# Вернуться на основную ветку
git checkout main

Ветки

# Посмотреть ветки (локальные)
git branch

# Все ветки включая удалённые
git branch -a

# Создать новую ветку и перейти в неё
git checkout -b feature/my-fix

# Переключиться на main
git checkout main

# Слить ветку в main
git merge feature/my-fix

Сохранение изменений (если ты редактируешь)

# Что изменилось?
git status

# Добавить все изменения в индекс
git add .

# Зафиксировать с описанием
git commit -m "fix: исправить парсер"

# Отправить на GitHub
git push

Releases — официальные стабильные версии программы. Автор упаковывает код, добавляет changelog и прикрепляет готовые файлы. Это главное место для скачивания готовых программ.

Как сделать Pull Request: пошаговo

1. Нажми Fork на странице репо → в твоём аккаунте появится копия
2. Клонируй свою копию:

   bash

   git clone https://github.com/ТВО_ИМЯЮЗЕРА/repo.git

3. Создай новую ветку:

   bash

   git checkout -b fix/my-bugfix

4. Внеси изменения в файлы, сохрани
5. Зафиксируй и отправь:

   bash

   git add .
   git commit -m "fix: описание исправления"
   git push origin fix/my-bugfix

6. На GitHub появится кнопка Compare & pull request — нажми, опиши изменение, отправь

Держать форк актуальным

# Добавить оригинальный репо как upstream (один раз)
git remote add upstream https://github.com/ORIGINAL/repo.git

# Скачать новые изменения из оригинала
git fetch upstream

# Влить в свою главную ветку
git merge upstream/main

Issues — система задач, встроенная в каждый репозиторий. Здесь сообщают об ошибках, просят новые функции, задают вопросы.

Issues как источник информации

Даже если не планируешь ничего сообщать — Issues полезны:

• Поищи свою проблему — возможно, решение уже есть в закрытых Issues
• Посмотри на количество открытых Issues — индикатор здоровья проекта
• Метка good first issue — с чего начать, если хочешь поучаствовать в разработке

Регистрация бесплатна на github.com/signup. Большинство возможностей доступны без аккаунта — он нужен для: звёзд, форков, Issues, Pull Requests, собственных репозиториев.

Что можно сделать в профиле

Настройка SSH (один раз, навсегда)

# Сгенерировать ключ
ssh-keygen -t ed25519 -C "ivan@example.com"

# Скопировать публичный ключ в буфер
cat ~/.ssh/id_ed25519.pub

Скопируй вывод → GitHub → Settings → SSH keys → New SSH key → вставь.

После этого используй SSH-ссылки при клонировании: git@github.com:owner/repo.git

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ПОЛУЧЕНИЕ КОД
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
git clone <url>                  # клонировать репо
git clone --depth 1 <url>       # клонировать без истории
git pull                         # обновить из remote
git fetch                        # скачать без слияния

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ИСТОРИЯ И НАВИГАЦИЯ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
git log --oneline               # краткая история
git log --oneline --graph       # история с ветками
git tag                          # список версий
git checkout <tag/branch>       # переключиться
git diff                         # что изменилось

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ВЕТКИ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
git branch                       # список веток
git branch -a                   # включая remote
git checkout -b <name>          # создать и перейти
git merge <branch>              # слить ветку
git branch -d <name>           # удалить ветку

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  СОХРАНЕНИЕ ИЗМЕНЕНИЙ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
git status                       # что изменилось
git add .                        # добавить всё
git add <file>                   # добавить конкретный
git commit -m "описание"       # зафиксировать
git push                         # отправить на GitHub
git push origin <branch>        # конкретная ветка

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ОТКАТ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
git restore <file>              # отменить изменение файла
git restore .                   # отменить все изменения
git reset --hard HEAD~1        # удалить последний коммит
git stash                       # временно сохранить изменения
git stash pop                   # вернуть из stash

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  КОНФИГУРАЦИЯ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
git config --global user.name  "Имя"
git config --global user.email "email"
git config --list              # все настройки
git remote -v                  # remote-адреса