Início·Comandos de terminal

git clone

git

Uso

git clone [--depth <n>] [-b <branch>] <url> [<directory>]

Copia um repositório remoto com o histórico; um clone --depth 1 não traz commits antigos nem outros branches, e depois exige --unshallow.

Opções comuns

OpçãoSignificado
--depth <n>shallow copy with only the last n commits
-b <branch>check out that branch instead of the default
--single-branchfetch one branch only
--recurse-submodulesclone submodules at the same time
--filter=blob:nonepartial clone: fetch file contents on demand
-o <name>call the remote something other than origin

Exemplos

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

copies the repository into repo/ and names the remote origin

git clone --depth 1 https://github.com/user/repo.git

fast copy for CI with no old history

git clone -b dev --single-branch <url>

checks out dev and fetches nothing else

O confuso é que desfazer tem várias formas: mover para onde um branch aponta não é o mesmo que criar um commit que reverte.

Como ler

  • Os colchetes [ ] marcam uma parte que você pode omitir.
  • As reticências … indicam que você pode listar vários.
  • As opções diferenciam maiúsculas: em alguns comandos -r e -R fazem coisas diferentes.

Perguntas

Q. O que git clone faz?

Copia um repositório remoto com o histórico; um clone --depth 1 não traz commits antigos nem outros branches, e depois exige --unshallow.

Q. Como se digita?

git clone [--depth <n>] [-b <branch>] <url> [<directory>] — os colchetes marcam o que você pode omitir.

Q. Quantas opções vale a pena saber?

Aqui estão 6; a lista completa está em man git. Este comando fica em git.

Comandos relacionados

página man: man git-clone