Comandos¶
Nesta seção veremos uma lista (não exaustiva) dos comandos mais utilizados enquanto usamos git. Para uma lista exaustiva, consulte a documentação oficial.
Comandos do sistema operacional¶
Os comandos do sistema operacional são independentes do git, e podem ser utilizados inclusive sem git.
Acessar um novo diretório¶
Windows, Linux:
cd <diretório>
Exemplo:
cd Downloads
Listar arquivos em um diretório¶
Windows:
dir <diretório>
Linux:
ls <diretório>
Exemplo:
Windows:
dir
dir Downloads
Linux:
ls
ls Downloads
Limpar tela¶
Exemplo:
Windows:
cls
Linux:
clear
Comandos do git¶
Esta seção apresenta apenas um resumo sobre os comandos do git. Cada um destes comandos possui mais parâmetros e funções do que as listadas aqui, porém espera-se que este resumo seja suficiente para programadores iniciantes.
Nota
é preciso estar dentro de uma pasta que é um repositório git para estes comandos funcionarem.
Nota
Alguns destes comandos dependem do estado atual do repositório, que pode ser consultado com um
git status. Em outras palavras, se você der este comando fora da sequência correta, ele não terá o efeito
desejado. Por outro lado, os comandos que não dependem de estado são relativamente inofensivos caso foram usados
fora da ordem correta.
Consulte a Seção Fluxogramas para visualizar em qual etapa os comandos são mais apropriados.
git clone¶
Copia um repositório remoto para a máquina local, se o repositório não existir na máquina local. Não confundir com a funcionalidade do git pull.
Sintaxe:
git clone <url do repositório>
Exemplo:
git clone https://github.com/CTISM-Prof-Henry/gitEssentials
git status¶
Mostra o status do repositório na máquina local.
Sintaxe e exemplo:
git status
git add¶
Adiciona arquivos à lista de modificações-candidatas a serem salvas. Não confundir com a funcionalidade do git commit.
Sintaxe:
git add <parâmetro>
Exemplo:
git add . # adiciona todos os arquivos da pasta atual
git add * # adiciona todos os arquivos da pasta atual
git add README.md # adiciona apenas o arquivo README.md
git add README.md main.py estilo.css # adiciona uma lista de arquivos
git restore¶
Descarta modificações que foram feitas em um arquivo.
Sintaxe:
git restore <parâmetro>
Exemplo:
git restore README.md # descarta modificações que foram feitas no README.md
git restore . # descarta modificações que foram feitas nos arquivos da pasta atual
git commit¶
Salva as modificações feitas no repositório local, em um checkpoint (também chamado de commit).
Nota: só pode ser utilizado após um git add.
Sintaxe e exemplo:
git commit -m "mensagem explicando o que foi feito neste commit"
git push¶
Uso 1: Envia modificações da atual branch local para uma branch do repositório remoto, dado que as modificações já foram salvas.
Nota 1: só pode ser utilizado após um git commit.
Nota 2: é uma boa prática ser precedido por um git pull.
Nota 3: caso você esteja trabalhando em um repositório que é uma
cópia de outro repositório (vide Fazendo fork e pull
requests), você deve adicionar a flag
-u ao comando.
Sintaxe:
git push origin <nome da branch remota>
Exemplo:
git push origin main # envia para a branch remota main
git push origin top # envia para a branch remota top
git push origin -u top # envia para a branch remota top que referencia outro repo
Uso 2: deleta uma branch remota. Veja git branch para ver como deletar uma branch local.
Sintaxe:
git push origin --delete <nome da branch remota>
Exemplo:
git push origin --delete top # deleta a branch remota top
git pull¶
Baixa as modificações da branch de um repositório remoto para a atual branch da máquina local, se o repositório já existir na máquina local. Não confundir com a funcionalidade do git clone.
Sintaxe:
git pull origin <nome da branch remota>
Exemplo:
git pull origin main # baixa da branch remota main
git pull origin top # baixa da branch remota top
git checkout¶
Muda de uma branch local para outra.
Sintaxe:
git checkout <nome da branch local>
Exemplo:
git checkout top # troca da branch atual para a branch top
git checkout main # troca da branch atual para a branch main
git branch¶
Uso 1: lista as branches locais.
Sintaxe e exemplo:
git branch
Uso 2: deleta uma branch local. Veja git push para deletar uma branch remota.
Nota: tenha certeza que você não está dentro da branch que será deletada. Veja git checkout para ver como trocar de uma branch para outra.
Sintaxe:
git branch -d <nome da branch local>
Exemplo:
git branch -d top # deleta a branch local top
git. Documentação oficial. Disponível em https://git-scm.com/doc. Acesso em 01/12/2022.