Как скопировать репозиторий github на компьютер

Обновлено: 21.11.2024

Ранее из этого учебника вы узнали, что git — это инструмент, который используется для отслеживания изменений в файлах (процесс, называемый контролем версий) с помощью набора команд, которые вы можете выполнять в Терминале. Вы также узнали, что GitHub позволяет хранить файлы в облаке, чтобы получать к ним доступ с любого компьютера и делиться ими с другими.

Наличие копии набора файлов, хранящихся в репозиториях GitHub в облаке, идеально, потому что:

Есть резервная копия: если с вашим компьютером что-то случится, файлы по-прежнему доступны в Интернете.
Вы можете легко делиться файлами с другими людьми.
Вы даже можете создать цифровой идентификатор объекта (DOI) с помощью сторонних инструментов, таких как Zenodo, чтобы цитировать ваши файлы или просить других цитировать ваши файлы. Вы также можете добавить эти DOI в свое резюме или автобиографию. для продвижения вашей работы.

Структура каталогов репозиториев

По сути, репозиторий — это каталог для определенного проекта, который определяется как репозиторий git и GitHub, поскольку он содержит подкаталог с именем .git .

Типичный репозиторий (например, название проекта) имеет следующую структуру:

Файл README.md. Это файл в формате Markdown, который используется для предоставления описания репозитория (т. е. его содержимого, назначения и т. д.), чтобы другие могли узнать, как использовать файлы в репозитории.
Файл .gitignore: этот файл можно использовать для списка файлов, которые вы не хотите отслеживать с помощью git (т. е. контролировать с помощью контроля версий). Вы узнаете больше об обоих этих полезных файлах позже в этой главе.

В любом случае (общедоступном или частном) URL-ссылки на репозиторий GitHub всегда имеют один и тот же формат:

Имя пользователя — это имя пользователя создателя (т. е. владельца) репозитория. Имя пользователя может быть либо физическим лицом, например eastudent (или вашим именем пользователя GitHub!), либо представлять организацию, например earthlab-education .

Например, репозитории, с которыми вы будете работать в этом учебнике, будут принадлежать earthlab-education и, таким образом, будут иметь следующие URL-адреса:

Возможность разветвления репозитория является преимуществом использования репозиториев GitHub, поскольку разветвленный репозиторий связан с исходным. Это означает, что вы (или другие пользователи) можете обновлять файлы в своем форке из исходного в ваш (или их) форкированный репозиторий. Это также означает, что вы можете предлагать изменения в исходном репозитории, которые могут быть просмотрены владельцем этого репозитория. Таким образом, разветвление позволяет вам сотрудничать с другими, защищая исходные версии файлов. При совместной работе все будут работать с копиями исходных файлов. Все изменения отслеживаются в истории каждого файла и могут быть отменены в любое время.

Перейдите на страницу репозитория, которую вы хотите разветвить, например:

На этой странице вы увидите кнопку в ВЕРХНЕМ ПРАВОМ углу с надписью Fork . Число рядом с этой кнопкой показывает, сколько раз репозиторий уже был разветвлен.
Нажмите кнопку "Разветвить" и выберите свою учетную запись пользователя, когда она спросит вас, где вы хотите разветвить репозиторий.
После разветвления репозитория его копия появится в вашем аккаунте. Перейдите на страницу репозитория. URL-адрес должен выглядеть примерно так:

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

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

Для локальной работы с репозиторием GitHub (включая разветвленные репозитории) вам необходимо создать локальную копию этого репозитория на своем компьютере (эта задача называется клонированием репозитория). Вы можете клонировать репозитории GitHub, которые принадлежат вам или другим лицам (например, репозитории, которые вы разветвили в своей учетной записи GitHub).

Используйте Bash для перехода в нужный рабочий каталог

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

Для этого учебника вы клонируете репозиторий в каталог earth-analytics на своем компьютере (или где бы вы ни работали. Этот каталог earth-analytics должен находиться в домашнем каталоге вашего компьютера.

Чтобы запустить команду git clone, вам нужен URL-адрес репозитория, который вы хотите клонировать (т. е. либо репозитория, принадлежащего вам, либо созданного вами ответвления репозитория другого пользователя).

Вы можете создать локальную копию разветвленного репозитория на своем компьютере с помощью команды git clone.

Запустите команду Git Clone в Терминале

Теперь, когда у вас есть URL-адрес репозитория, который вы хотите скопировать локально, вы можете использовать терминал для запуска команды git clone, за которой следует скопированный URL-адрес:

Теперь вы создали локальную копию репозитория в вашем каталоге earth-analytics. Вы можете дважды проверить, существует ли каталог, используя команду ls в терминале.

Испытание: разветвить и клонировать репозиторий

Чтобы убедиться, что вы все сделали правильно, в bash перейдите в каталог практика-git-skillz на вашем компьютере. Тип:

Вы можете использовать GitHub Desktop для клонирования и создания ответвлений репозиториев, существующих на GitHub.

О локальных репозиториях

Репозитории на GitHub — это удаленные репозитории. Вы можете клонировать или разветвить репозиторий с помощью GitHub Desktop, чтобы создать локальный репозиторий на своем компьютере.

Вы можете создать локальную копию любого репозитория на GitHub, к которому у вас есть доступ, путем клонирования репозитория. Если у вас есть репозиторий или права на запись, вы можете синхронизировать локальное и удаленное расположение. Дополнительные сведения см. в разделе «Синхронизация ветки».

При клонировании репозитория любые изменения, которые вы отправляете на GitHub, повлияют на исходный репозиторий. Чтобы внести изменения, не затрагивая исходный проект, вы можете создать отдельную копию, разветвив репозиторий. Вы можете создать запрос на вытягивание, чтобы предложить мейнтейнерам включить изменения в вашем форке в исходный основной репозиторий. Дополнительную информацию см. в разделе "О вилках".

При попытке использовать GitHub Desktop для клонирования репозитория, к которому у вас нет прав на запись, GitHub Desktop автоматически предложит создать ответвление. Вы можете использовать свой форк для внесения вклада в исходный основной репозиторий или для самостоятельной работы над своим собственным проектом. Любые существующие форки по умолчанию вносят изменения в свои вышестоящие репозитории. Вы можете изменить этот выбор в любое время. Дополнительные сведения см. в разделе «Управление поведением ветки».

Вы также можете клонировать репозиторий напрямую из GitHub или GitHub Enterprise. Дополнительные сведения см. в разделе «Клонирование репозитория из GitHub в GitHub Desktop».

Клонирование репозитория

В меню "Файл" выберите "Клонировать репозиторий".

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

Выберите из списка репозиторий, который хотите клонировать.

Нажмите «Выбрать». и перейдите к локальному пути, по которому вы хотите клонировать репозиторий.

Нажмите "Клонировать".

Разветвление репозитория

Если вы клонируете репозиторий, к которому у вас нет прав на запись, GitHub Desktop создаст ответвление. После создания или клонирования вилки GitHub Desktop спросит, как вы планируете использовать вилку.

В меню "Файл" выберите "Клонировать репозиторий".

Выберите из списка репозиторий, который хотите клонировать.

Нажмите «Выбрать». и перейдите к локальному пути, по которому вы хотите клонировать репозиторий.

Нажмите "Клонировать".

Если вы планируете использовать эту ветку для внесения вклада в исходный вышестоящий репозиторий, нажмите Внести вклад в родительский проект.

Если вы планируете использовать эту ветку для проекта, не связанного с исходным потоком, нажмите «Для моих собственных целей».

Нажмите "Продолжить".

Управление поведением ветки

Вы можете изменить поведение ответвления с вышестоящим репозиторием в GitHub Desktop.

Откройте меню «Репозиторий», затем нажмите «Настройки репозитория». .

Нажмите "Поведение вилки", затем выберите, как вы хотите использовать вилку.

Нажмите "Сохранить".

Создание псевдонима для локального репозитория

Вы можете создать псевдоним для локального репозитория, чтобы различать репозитории с одинаковыми именами в GitHub Desktop. Создание псевдонима не влияет на имя репозитория на GitHub. В списке репозиториев псевдонимы выделены курсивом.

Помогите нам сделать эти документы лучше!

Все документы GitHub имеют открытый исходный код. Видите что-то неправильное или непонятное? Отправьте запрос на вытягивание.

О клонировании репозитория

При клонировании репозитория создается полная копия всех данных репозитория, которые есть на GitHub.com на данный момент, включая все версии каждого файла и папки для проекта. Вы можете отправить свои изменения в удаленный репозиторий на GitHub.com или получить изменения других людей с GitHub.com. Дополнительные сведения см. в разделе «Использование Git».

Вы можете клонировать свой существующий репозиторий или клонировать существующий репозиторий другого человека, чтобы внести свой вклад в проект.

Клонирование репозитория

Над списком файлов нажмите

Код.

Чтобы клонировать репозиторий с помощью HTTPS, в разделе "Клонировать с HTTPS" нажмите

<р>. Чтобы клонировать репозиторий с помощью ключа SSH, включая сертификат, выданный центром сертификации SSH вашей организации, нажмите «Использовать SSH», затем нажмите

<р>. Чтобы клонировать репозиторий с помощью интерфейса командной строки GitHub, нажмите «Использовать интерфейс командной строки GitHub», затем нажмите

<р>.

Открыть Терминал Терминал Git Bash.

Измените текущий рабочий каталог на место, где вы хотите создать клонированный каталог.

Введите git clone и вставьте скопированный ранее URL-адрес.

Нажмите Enter, чтобы создать локальный клон.

Подробнее о интерфейсе командной строки GitHub см. в разделе "О интерфейсе командной строки GitHub".

Чтобы клонировать репозиторий локально, используйте подкоманду repo clone. Замените параметр репозитория именем репозитория. Например, octo-org/octo-repo, monalisa/octo-repo или octo-repo. Если часть OWNER/ аргумента репозитория OWNER/REPO опущена, по умолчанию используется имя аутентифицирующего пользователя.

Вы также можете использовать URL-адрес GitHub для клонирования репозитория.

Клонирование пустого репозитория

Пустой репозиторий не содержит файлов. Это часто делается, если вы не инициализируете репозиторий файлом README при его создании.

Чтобы клонировать репозиторий с помощью командной строки по протоколу HTTPS, в разделе "Быстрая настройка" нажмите

<р>. Чтобы клонировать репозиторий с помощью ключа SSH, включая сертификат, выданный центром сертификации SSH вашей организации, нажмите SSH, затем нажмите

<р>.

Кроме того, чтобы клонировать репозиторий на рабочем столе, нажмите

Настройте на рабочем столе и следуйте инструкциям, чтобы завершить клонирование.

Открыть Терминал Терминал Git Bash.

Измените текущий рабочий каталог на место, где вы хотите создать клонированный каталог.

Введите git clone и вставьте скопированный ранее URL-адрес.

Нажмите Enter, чтобы создать локальный клон.

Устранение ошибок клонирования

При клонировании репозитория возможны ошибки.

Если вам не удается клонировать репозиторий, проверьте следующее:

Вы можете подключиться с помощью HTTPS. Дополнительные сведения см. в разделе "Ошибки клонирования HTTPS".
У вас есть разрешение на доступ к репозиторию, который вы хотите клонировать. Дополнительные сведения см. в разделе "Ошибка: репозиторий не найден".
Ветка по умолчанию, которую вы хотите клонировать, все еще существует. Дополнительную информацию см. в разделе "Ошибка: Remote HEAD ссылается на несуществующую ссылку, невозможно извлечь".

Помогите нам сделать эти документы лучше!

Уметь использовать команду git clone для создания локальной версии репозитория GitHub на вашем компьютере.

Дополнительные ресурсы

Схема команд Git. Эта диаграмма включает в себя больше команд, чем мы рассмотрим в этой серии, но включает все, что мы используем для нашего стандартного рабочего процесса.
GitHub Help Изучение ресурсов Git.

Клонировать — скопировать репозиторий на свой компьютер

Теперь мы узнаем, как создать локальную версию нашего разветвленного репозитория на нашем ноутбуке, чтобы мы могли эффективно добавлять и редактировать содержимое репозитория.

Когда вы клонируете репозиторий на свой локальный компьютер, вы создаете копию того же репозитория локально на своем компьютере. Это позволяет редактировать файлы на вашем компьютере. И, конечно же, это еще один бэкап материала! Источник: Национальная сеть экологических обсерваторий (NEON)

Скопировать URL репозитория

Затем на локальном компьютере:

На вашем компьютере уже должны быть установлены Git и интерфейс оболочки bash. Если нет, перед продолжением обратитесь к установочным материалам Института.
Откройте bash на своем компьютере и перейдите в локальный каталог GitHub, созданный с помощью материалов для настройки.

Для этого в командной строке введите:

Примечание. Если вы сохранили каталог GitHub в другом месте

т.е. это не /Documents/GitHub , обязательно измените приведенный выше код так, чтобы он представлял фактический путь к каталогу GitHub на вашем компьютере.

Теперь используйте git clone для клонирования или создания копии всего репозитория в каталоге GitHub на вашем компьютере.

**Совет по данным.** Вы являетесь пользователем Windows и испытываете затруднения при копировании URL-адреса в оболочку? Вы можете копировать и вставлять в среду оболочки **после** включения этой функции. Щелкните правой кнопкой мыши окно оболочки bash (вверху) и выберите «Свойства». Убедитесь, что «быстрое редактирование» отмечено. Теперь вы должны иметь возможность копировать и вставлять в среде bash.

Вывод показывает, что клонируется на ваш компьютер.

Примечание. Выходные числа, которые вы видите на своем компьютере, представляющие общий размер файла и т. д., могут отличаться от приведенного выше примера.

Просмотреть новый репозиторий

Далее убедитесь, что репозиторий создан на вашем компьютере именно там, где вы думаете.

В командной строке введите ls, чтобы просмотреть содержимое текущего каталога.

Затем перейдите к своей копии репозитория института данных с помощью компакт-диска или изменения каталога:

Кроме того, мы можем просмотреть локальное репозиторий DI-NEON-участников в окне поиска (Mac) или в проводнике Windows (Windows). Просто откройте свои документы в окне и перейдите к новому локальному репозиторию.

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

**Вопрос для размышления:** Является ли клонированная версия этого репозитория, которую вы только что создали на своем ноутбуке, прямой копией центрального репозитория NEON -ИЛИ- вашей разветвленной версии центрального репозитория NEON?

Краткий рабочий процесс — создание локального репозитория

Скопируйте URL репозитория, с которым вы хотите работать локально

Примечание: вы можете скопировать URL своего репозитория прямо из GitHub.

Есть вопросы? Без проблем. Оставьте свой вопрос в поле для комментариев ниже. Вероятно, у некоторых из ваших коллег тоже есть такой же вопрос! А также, вероятно, кто-то еще знает ответ.

Маршалл Ганнелл

Маршалл Ганнелл
Писатель

Маршалл — писатель с опытом работы в сфере хранения данных. Он работал в Synology, а совсем недавно был директором по маркетингу и техническим писателем в StorageReview. В настоящее время он работает техническим писателем по API/программному обеспечению в Токио, Япония, управляет VGKAMI и ITEnterpriser и тратит то немногое свободное время, которое у него есть, на изучение японского языка. Подробнее.

При клонировании репозитория GitHub создается локальная копия удаленного репозитория. Это позволяет вам вносить все ваши изменения локально, а не непосредственно в исходные файлы исходного репозитория. Вот как можно клонировать репозиторий GitHub.

Первое, что вам нужно сделать, это загрузить и установить Git на свой компьютер. Процесс установки прост и дает вам много шаблонной информации. Единственное, с чем вы должны быть осторожны, это то, что вы разрешаете использовать Git из командной строки.

Позвольте мастеру выполнить все остальные действия. После завершения установки вы будете готовы клонировать репозиторий GitHub.

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

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

В правой части экрана под вкладкой "Соавторы" вы увидите зеленую кнопку с надписью "Клонировать или скачать". Нажмите на это. В появившемся окне выберите значок «Буфер обмена», чтобы скопировать URL-адрес репозитория в буфер обмена.

Затем откройте командную строку (в Windows) или любой другой терминал, который вы используете на своем компьютере.

В терминале перейдите к месту, где вы хотите сохранить репозиторий. Вы можете сделать это, введя следующую команду:

В нашем примере мы должны ввести $ cd Documents\GIT local .

Примечание. Вы можете пропустить этот шаг, используя вместо этого git для клонирования репозитория непосредственно в указанный каталог.

Теперь, когда URL-адрес репозитория все еще скопирован в буфер обмена, пришло время клонировать репозиторий. Введите следующую команду:

Подождите, пока процесс завершится. Вот как это выглядит, если все прошло гладко.

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

Здесь видно, что репозиторий «javascript-algorithms» был успешно клонирован в нашу папку «Git local».

Теперь вы можете приступить к редактированию каталога с помощью вашего любимого текстового редактора!

› Как конвертировать установочные пакеты Linux в другие форматы
› Как (и зачем) создавать репозиторий GitHub
› Как проверить и обновить версию Git
› Как разветвить репозиторий GitHub
› 7 основных функций Microsoft Excel для составления бюджета
› 5 вещей, которые вы, вероятно, не знали о GIF-файлах
› Matter — это долгожданный стандарт умного дома
› QWERTY-клавиатура — самая большая неразгаданная тайна технологий

Читайте также: