Git na prática: principais comandos para desenvolvedores de todos os níveis

Se preferir, já salve este artigo nos favoritos, pois ele será útil para consultar quando as dúvidas aparecerem!

O que é Git e por que usá-lo?

• Versionamento de código: possibilita revisar versões anteriores do projeto, identificar responsáveis por determinadas alterações e até mesmo reverter mudanças, se necessário.

• Colaboração eficiente: cada integrante da equipe (ou colaborador open source) pode trabalhar em paralelo, criando suas próprias ramificações (branches) e enviando suas contribuições para o repositório remoto (GitHub, GitLab, Bitbucket etc.).

• Organização e escalabilidade: desde pequenos projetos pessoais até grandes sistemas em produção, o Git se adapta perfeitamente.

Configuração inicial

Configurando o nome de usuário e e-mail

git config --global user.name "Diego Fernandes"

git config --global user.email "diego@exemplo.com.br"

• --global: significa que essas configurações serão aplicadas em todos os repositórios do seu usuário no computador.

• --local: as configurações valem apenas para o repositório atual.

• --system: configurações para todos os usuários e todos os repositórios da máquina (geralmente requer privilégios de administrador).

Comandos para repositórios

1. Inicializando um repositório

git init

• Esse comando cria uma pasta oculta chamada .git/, onde o Git armazenará todo o histórico, metadados e configurações internas do projeto.

• Após executar git init, você pode conferir a nova pasta .git/ rodando ls -a no terminal (ou exibindo arquivos ocultos na sua IDE).

Utilize git status logo após o git init para verificar o estado do novo repositório e entender quais arquivos já estão sendo rastreados.

2. Clonando um repositório existente

git clone <URL-do-repositório>

git clone https://github.com/rocketseat-education/awesome-project.git

• O Git baixará o repositório completo, incluindo todo o histórico de commits, branches, tags e demais metadados.

• Esse é o ponto de partida quando você deseja colaborar em um projeto open source ou em um repositório da sua equipe.

Caso o repositório seja privado, será necessário ter permissão de acesso ou usar tokens/chaves SSH conforme a plataforma em questão.

3. Criando o arquivo .gitignore

• Diretórios de dependências (ex:. node_modules/).

• Arquivos de configuração local (ex.: .env).

• Pastas de build ou distribuição (ex.: dist/, build/).

node_modules/
.env
dist/

É importante manter informações sensíveis fora do repositório. Se por acaso você versionou algo que não deveria (como senhas ou chaves de API), revise seu histórico e remova esses dados o quanto antes para evitar problemas de segurança.

Trabalhando com alterações

1. Verificando o status do repositório

git status

• Exibe quais arquivos foram criados, modificados, removidos ou ainda não rastreados (untracked) desde o último commit.

• É o comando principal para verificar o que está acontecendo no seu repositório a qualquer momento.

Rodar git status frequentemente ajuda a manter o controle do que foi alterado e do que ainda precisa ser adicionado ou commitado.

2. Adicionando alterações à área de staging

# Adiciona todas as alterações
git add .

# Adiciona um arquivo específico
git add index.html

# Adiciona todos os arquivos .js
git add *.js

• Após o git add, as alterações ficam prontas para serem incluídas no próximo commit.

• Área de staging (também chamada de index): é como uma “sala de preparação”, onde você coloca apenas as mudanças que deseja enviar ao histórico.

Suponha que você alterou vários arquivos, mas quer fazer um commit específico apenas no index.html. Basta fazer git add index.html para que apenas esse arquivo seja colocado na área de staging.

3. Criando um commit

git commit -m "Adiciona funcionalidade de login"

• Ao criar um commit, você “tira uma foto” do estado do seu projeto naquele momento.

• A mensagem de commit deve ser clara e concisa, descrevendo o que foi feito e, preferencialmente, por que foi feito.

git commit -m "Corrige validação de email no formulário de cadastro"

📽️

Gostou do conteúdo? Confira esse video onde o Diego Fernandes explica como ele faz para criar os commits:

4. Visualizando as diferenças

# Alterações no diretório de trabalho em relação à área de staging
git diff

# Alterações já adicionadas em relação ao último commit
git diff --staged

• git diff exibe as mudanças linha a linha, permitindo que você revise tudo antes de confirmar o commit.

• Excelente recurso para verificar pequenas alterações ou certificar-se de que não está enviando algo indevido ao repositório.

Se você editou um arquivo CSS e quer ter certeza de que as alterações estão corretas, use git diff style.css para ver a comparação exata do que foi modificado.

5. Visualizando o histórico de commits

# Histórico completo e detalhado
git log

# Histórico resumido (um commit por linha)
git log --oneline

# Exibe o histórico em formato de grafo (ótimo para ver branches)
git log --graph --oneline

• git log permite navegar pelo histórico de commits, visualizar mensagens, autores, datas e até mesmo merges.

• Você pode combinar opções como -oneline e -graph para enxergar melhor as ramificações do seu projeto.

Se o histórico estiver muito longo, use git log --oneline --graph --decorate para ver commits em apenas uma linha, com visualização das branches e tags.

Gerenciamento de branches (ramificações)

1. Listando, criando e removendo branches

# Lista todas as branches
git branch

# Cria uma nova branch
git branch feature/login

# Deleta uma branch
git branch -d feature/login

# Força a deleção de uma branch (caso não tenha sido mesclada)
git branch -D feature/login

• Use git branch para ver em qual branch você está e quais outras existem no repositório.

• É comum usar nomes que descrevam a funcionalidade ou correção sendo desenvolvida, como feature/login ou fix/navbar-bug.

Quando iniciar uma nova funcionalidade, crie uma branch com git branch feature/nome-da-feature. Assim, mantém o trabalho organizado e independente das outras partes do projeto.

2. Mudando entre branches

# Muda para uma branch existente
git checkout feature/login

# Cria e já muda para a nova branch
git checkout -b feature/dashboard

• git checkout <nome-da-branch> permite alternar entre diferentes linhas de desenvolvimento.

• A flag b cria a branch e já realiza o checkout em uma única etapa.

No Git mais recente, você também pode usar git switch <branch> ou git switch -c <branch> para se mover entre branches, dependendo da sua versão do Git.

3. Juntando branches

git checkout main
git merge feature/login

• Depois que você concluir o desenvolvimento na branch feature/login, pode mesclar as alterações na branch principal (geralmente chamada de main ou master).

• Se houver conflitos, resolva-os manualmente ou usando ferramentas de merge e finalize com um git commit.

4. Reorganizando o histórico (rebase)