Clonar um repositório

Sobre clonagem de um repositório

Você pode clonar um repositório do GitHub 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 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 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 ou extrair as alterações de outras pessoas no GitHub. 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 usando a linha de comando

1. No GitHub, navegue até a página principal do repositório.

2. Acima da lista de arquivos, clique em código.

3. Para clonar o repositório usando HTTPS, em "Clonar com HTTPS", clique em . Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade certificada e SSH da sua organização, clique em Usar SSH e, em seguida, clique em . Para clonar um repositório usando GitHub CLI, clique em Usar GitHub CLI e, em seguida, clique em .

   

4. Abra TerminalTerminalGit Bash.

5. Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado.

6. Digite git clone (clonar git) e cole a URL que você copiou anteriormente.

   $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY

7. 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.

Clonar um repositório no GitHub Desktop

1. No GitHub, navegue até a página principal do repositório.

2. Acima da lista de arquivos, clique em código.

3. Clique em Abra com GitHub Desktop para clonar e abrir o repositório com GitHub Desktop.

4. 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 README ao criá-lo.

1. No GitHub, navegue até a página principal do repositório.

2. 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.

3. Abra TerminalTerminalGit Bash.

4. Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado.

5. Digite git clone (clonar git) e cole a URL que você copiou anteriormente.

   $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY

6. 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 obter mais informações, consulte a permissão para acessar o repositório que você deseja clonar. Para ibter mais informações, consulte "Erro: o HEAD remoto refere-se a uma ref inexistente, incapaz de fazer checkout".

Leia mais

• "Solucionar problemas de conectividade"