Sobre clonagem de um repositório
Você pode clonar um repositório do GitHub.com para o seu computador local para facilitar a correção de conflitos de merge, adicionar ou remover arquivos e fazer push de commits maiores. Ao clonar um repositório, você copia o repositório do GitHub.com para a sua máquina local.
Clonar um repositório extrai uma cópia completa de todos os dados do repositório que o GitHub.com tem nesse momento, incluindo todas as versões de cada arquivo e pasta do projeto. Você pode fazer push das alterações no repositório remoto no GitHub.com ou extrair as alterações de outras pessoas no GitHub.com. Para obter mais informações, consulte "Usar o Git.
É possível clonar o repositório existente ou clonar o repositório existente de outra pessoa para contribuir para um projeto.
Clonar um repositório
-
No GitHub.com, navegue até a página principal do repositório.
-
Acima da lista de arquivos, clique em código.
-
Copy the URL for the repository.
- To clone the repository using HTTPS, under "HTTPS", click .
- Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade de certificação SSH da sua organização, clique em SSH e, em seguida, clique em .
- To clone a repository using GitHub CLI, click GitHub CLI, then click .
-
Abra TerminalTerminalGit Bash.
-
Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado.
-
Digite
git clone
(clonar git) e cole a URL que você copiou anteriormente.$ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
-
Pressione Enter para criar seu clone local.
$ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY > Cloning into `Spoon-Knife`... > remote: Contando objetos: 10, concluído. > remote: Compactando objetos: 100% (8/8), concluído. > remove: Total 10 (delta 1), reused 10 (delta 1) > Unpacking objects: 100% (10/10), done.
Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."
Para clonar um repositório localmente, use o subcomando repo clone
. Substitua o parâmetro repositório
pelo nome do repositório. Por exemplo, octo-org/octo-repo
, monalisa/octo-repo
ou octo-repo
. Se a porção OWNER/
do argumento do repositório OWNER/REPO
for omitida, o padrão será o nome do usuário autenticador.
gh repo clone repository
Você também pode usar o URL do GitHub para clonar um repositório.
gh repo clone https://github.com/cli/cli
- No GitHub.com, navegue até a página principal do repositório.
- Acima da lista de arquivos, clique em código.
- Click Open with GitHub Desktop to clone and open the repository with GitHub Desktop.
- Siga as solicitações no GitHub Desktop para concluir o clone.
Para obter mais informações, consulte "Clonar um repositório do GitHub para o GitHub Desktop".
Clonar um repositório vazio
Um repositório vazio não contém arquivos. Muitas vezes, isso é feito se você não inicializar o repositório com um LEIAME ao criá-lo.
-
No GitHub.com, navegue até a página principal do repositório.
-
Para clonar seu repositório usando a linha de comando usando HTTPS, em "Configuração rápida", clique no . Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade de certificação SSH da sua organização, clique em SSH e, em seguida, clique em .
Como alternativa, para clonar seu repositório para área de trabalho, clique em Configurar na área de trabalho e seguir as instruções para concluir o clone.
-
Abra TerminalTerminalGit Bash.
-
Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado.
-
Digite
git clone
(clonar git) e cole a URL que você copiou anteriormente.$ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
-
Pressione Enter para criar seu clone local.
$ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY > Cloning into `Spoon-Knife`... > remote: Contando objetos: 10, concluído. > remote: Compactando objetos: 100% (8/8), concluído. > remove: Total 10 (delta 1), reused 10 (delta 1) > Unpacking objects: 100% (10/10), done.
Solucionar problemas de erros de clonagem
Ao clonar um repositório, é possível que você encontre alguns erros.
Se você não conseguir clonar um repositório, verifique se:
- Você consegue conectar-se usando HTTPS. Para obter mais informações, consulte "Erros de clonagem por meio de HTTPS".
- Você tem permissão para acessar o repositório que você deseja clonar. Para obter mais informações, consulte "Erro: Repositório não encontrado".
- O branch-padrão que você deseja clonar ainda existe. Para ibter mais informações, consulte "Erro: o HEAD remoto refere-se a uma ref inexistente, incapaz de fazer checkout".