Справочник · Git

git clone: копия репозитория на компьютер

Редакция PraktumОбновлено 24 октября 20267 мин чтенияУровень: новичок

Команда git clone скачивает удалённый репозиторий целиком — все файлы и всю историю коммитов — в новую папку на компьютере. Достаточно передать адрес: git clone https://github.com/user/project.git. После клонирования можно работать с проектом локально и отправлять изменения обратно через git push.

Минимальный пример

git clone https://github.com/user/praktum-site.git
cd praktum-site
git status

Git создаст папку praktum-site, скачает в неё файлы и историю, переключится на основную ветку. После cd в эту папку проект готов к работе: git status покажет «nothing to commit, working tree clean».

Что делает git clone

Проверить адрес удалённого репозитория можно командой git remote -v, список всех веток — git branch -a.

В какую папку клонировать

git clone https://github.com/user/praktum-site.git              # папка praktum-site
git clone https://github.com/user/praktum-site.git my-site      # папка my-site
mkdir site && cd site && git clone https://github.com/user/praktum-site.git .  # в текущую

Точка в конце означает «в текущую папку» — она должна быть пустой. Не клонируй репозиторий внутрь другого репозитория: получится вложенная папка с собственным .git, и внешний Git перестанет видеть её файлы как обычные.

HTTPS или SSH

git clone https://github.com/user/project.git   # HTTPS
git clone git@github.com:user/project.git       # SSH

Адрес обоих видов есть на странице репозитория на GitHub под кнопкой Code. Публичный репозиторий по HTTPS скачивается без всякой настройки. Для приватного и для push по HTTPS нужен вход: GitHub не принимает пароль от аккаунта — нужен персональный токен или менеджер учётных данных (Git Credential Manager на Windows открывает окно входа сам). SSH требует один раз создать ключ и добавить его в настройки GitHub, зато потом не спрашивает пароль.

Полезные параметры

git clone --depth 1 --branch main https://github.com/user/big-project.git

Неглубокий клон (--depth 1) удобен, чтобы быстро посмотреть код или собрать проект. Если потом понадобится вся история, её можно докачать командой git fetch --unshallow.

Что делать после клонирования

git pull                       # забрать новые изменения с сервера
git switch -c feature/header   # создать ветку для своей работы
# … правки …
git add .
git commit -m "Добавить шапку"
git push -u origin feature/header

Клонируют один раз, дальше синхронизируются через git pull и git push. Перед началом работы всегда делай pull, чтобы не править устаревшие файлы. Свою задачу удобно делать в отдельной ветке и предлагать через pull request.

Clone или fork

git clone — команда Git: копия репозитория на твоём компьютере. Fork — функция GitHub: копия чужого репозитория в твоём аккаунте на сервере. Если у тебя нет права записи в чужой проект, сначала делают fork, затем клонируют свой fork, работают в нём и предлагают изменения автору через pull request.

Частые ошибки при клонировании

git clone или скачать ZIP

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

• Вводят пароль от GitHub при клонировании приватного репозитория по HTTPS вместо токена.
• Клонируют репозиторий внутрь другого репозитория.
• Скачивают ZIP, а потом удивляются, что не работает git push.
• Забывают cd в папку проекта и выполняют команды Git снаружи.
• Клонируют заново при каждом обновлении вместо git pull.

Доступность

Git работает в терминале, который хорошо читается скринридерами. Для тех, кому неудобна командная строка, есть графические клиенты (GitHub Desktop, встроенный Git в VS Code): кнопка «Clone repository» выполняет ту же команду. Сообщения об ошибках Git текстовые — их можно скопировать и найти решение.

Поддержка браузерами

git clone работает одинаково в Git для Windows, macOS и Linux. Параметр --depth и протоколы HTTPS и SSH поддерживаются всеми современными версиями Git и хостингами GitHub, GitLab и Bitbucket.

git clone https://github.com/user/project.git practice
cd practice
git remote -v
git branch -a
cd ..
git clone --depth 1 https://github.com/user/project.git practice-light
# сравни размеры: du -sh practice/.git practice-light/.git (macOS/Linux, Git Bash)