Trilha de aprendizado · Nível 2 · Tutorial 1

Criar e alternar branches com segurança

Criar uma linha de trabalho separada, registrar mudanças nela e alternar entre branches sem descartar alterações pendentes.

  • Nível: Iniciante
  • Duração: 15 min
  • 7 passos
Criar e alternar branches com segurança

O que você vai percorrer

  1. Entender o que uma branch representa Entenda como branches compartilham um histórico inicial e permitem registrar mudanças em linhas de trabalho separadas. 2 min
  2. Identificar a branch atual e a principal Leia a listagem de branches locais e use as orientações do projeto para distinguir a branch atual da principal. 2 min
  3. Verificar pendências antes de trocar Avalie as alterações pendentes e escolha uma conduta que preserve o trabalho antes de mudar de branch. 2 min
  4. Criar uma branch a partir da base correta Crie uma branch a partir da principal do seu repositório e confirme que ela passou a ser a branch atual. 2 min
  5. Registrar mudanças na branch de trabalho Registre uma pequena mudança e reúna evidências da branch correta, do novo commit e da ausência de pendências. 3 min
  6. Alternar e conferir os arquivos Alterne entre a principal e ajuste-texto, conferindo os arquivos e a preservação do commit registrado. 2 min
  7. Aplicar o fluxo seguro do início ao fim Organize o fluxo completo, aplique os comandos em um cenário de prática e decida como agir diante de alterações pendentes. 3 min

O que você vai aprender

  • Explicar como branches compartilham um histórico inicial e permitem desenvolver mudanças separadamente.
  • Identificar a branch atual e o nome da branch principal do repositório.
  • Verificar alterações pendentes e concluir o trabalho na branch apropriada antes de alternar.
  • Criar uma branch com git switch -c e alternar entre branches com git switch, reconhecendo as mudanças nos arquivos versionados.

Antes de começar

  • Registrar alterações em commits locais
  • Inspecionar alterações e histórico com diff e log

Passo 1 de 7

Entender o que uma branch representa

Entenda como branches compartilham um histórico inicial e permitem registrar mudanças em linhas de trabalho separadas.

Uma referência, não outra pasta

Um marcador no histórico

Uma branch é uma referência com nome que aponta para um commit. Pense nela como um marcador de uma linha de trabalho dentro do mesmo repositório — não como uma cópia independente da pasta do projeto.

Exemplo

O mesmo ponto de partida

Imagine dois commits em sequência, A e B, com a branch base apontando para B. Ao criar ajuste-menu a partir de base, a nova branch também aponta para B.

As duas compartilham os mesmos commits A e B. Criar a branch não duplica esse histórico.

Confira o ponto de partida

Histórico compartilhado

Logo após criar ajuste-menu a partir de base, ambas apontam para o mesmo commit e compartilham o histórico existente.

Uma linha de trabalho avança

O efeito de um novo commit

Agora, ajuste-menu é a branch ativa: aquela em que você está trabalhando. Você registra uma mudança no menu em um novo commit, C.

A referência de ajuste-menu avança para C. A referência de base continua em B: um commit na branch ativa não move automaticamente a outra branch.

Mesmo histórico inicial, referências diferentes

Diagrama com os commits A, B e C em sequência. A branch base aponta para B, enquanto ajuste-menu aponta para C. Os commits A e B fazem parte do histórico das duas branches.

A e B continuam compartilhados. C pertence apenas ao histórico de ajuste-menu neste exemplo.

Interprete a mudança

O que aconteceu com as branches?

Você registrou o commit C com ajuste-menu ativa. Qual descrição está correta?

Passo 2 de 7

Identificar a branch atual e a principal

Leia a listagem de branches locais e use as orientações do projeto para distinguir a branch atual da principal.

Qual branch está ativa?

Na pasta do repositório, execute git branch sem argumentos para listar as branches locais. O asterisco (*) ao lado de um nome identifica a branch atual.

Comando

bash
git branch

Exemplo de saída

Nesta listagem, a branch atual é main, pois ela está marcada com *.

plaintext
  ajustes-menu
* main
  trunk

Encontre a branch atual

Outra saída de git branch

plaintext
* ajustes-menu
  main
  trunk

Complete com o nome, sem o asterisco: a branch atual é ____.

Atual não significa principal

A branch atual é a que está ativa. Já o papel de branch principal é definido pela convenção do projeto: ela pode se chamar main, trunk ou ter outro nome.

A listagem de git branch, sozinha, não informa qual é a principal. O asterisco também não indica esse papel.

Dica

Confirme em vez de presumir

Consulte as orientações ou a documentação do projeto para confirmar o nome da principal. Se essa informação não estiver disponível, pergunte à pessoa responsável pelo projeto. Não deduza apenas pelo nome.

Combine as duas informações

Orientação do projeto de prática

A documentação informa: “Neste projeto, a branch principal se chama trunk.”

Saída de git branch

plaintext
  main
* revisao-texto
  trunk

Qual alternativa identifica corretamente a branch atual e a principal?

Passo 3 de 7

Verificar pendências antes de trocar

Avalie as alterações pendentes e escolha uma conduta que preserve o trabalho antes de mudar de branch.

Pendências não ficam isoladas por branch

Alterações ainda não commitadas, tanto nos arquivos de trabalho quanto na área de preparação, não ficam automaticamente guardadas na branch de origem.

Se forem compatíveis com o destino, elas podem acompanhar a troca. Se seriam sobrescritas, o Git pode impedir a operação.

Dica

Confira antes de decidir

Execute git status antes da troca. Se precisar conferir o conteúdo pendente, use git diff e git diff --staged, conforme o caso.

Preparar já garante o isolamento?

Depois de preparar minhas alterações com git add, posso trocar de branch com a garantia de que elas ficarão apenas na branch de origem.

Escolha a conduta segura

  • Sem pendências: siga para a troca planejada.
  • Trabalho pronto e pertencente à branch atual: confira, prepare o necessário e registre o commit nela. Depois, execute git status novamente.
  • Trabalho incompleto ou que não pertence à branch atual: interrompa a troca para definir a branch apropriada e como continuar o trabalho.

Atenção

Não tente apenas liberar a troca

Não faça um commit indiscriminado só para sair da branch. Se houver um bloqueio, preserve os arquivos e reavalie as pendências, sem forçar a operação.

Qual é o próximo passo?

Associe cada situação à conduta que preserva o trabalho.

Toque em um item e depois no par correspondente.

Passo 4 de 7

Criar uma branch a partir da base correta

Crie uma branch a partir da principal do seu repositório e confirme que ela passou a ser a branch atual.

Confira a base antes de criar

Continue no seu repositório de prática

Use o repositório já utilizado na trilha, no ponto em que a branch principal está ativa e o trabalho anterior está registrado, sem pendências. Use o nome real confirmado no projeto, como main ou master: principal é apenas um exemplo de nome, não uma exigência. Não é necessário renomear nada.

Inspecione o ponto de partida

bash
git branch
git status

Dica

Resultado esperado

O asterisco deve estar ao lado do nome real da principal, e o status deve indicar que não há alterações pendentes. Se houver pendências, aplique a decisão de segurança da etapa anterior antes de continuar.

Um comando, duas ações

git switch -c <nova-branch> cria uma branch a partir do commit atual e muda imediatamente para ela. Substitua <nova-branch> pelo novo nome desejado. O comando parte da branch atual; ele não escolhe a principal automaticamente.

Complete o comando

Criar e já começar nela

A principal está ativa e não há pendências. Complete com a opção que cria a nova branch ajuste-texto e muda para ela:

git switch ____ ajuste-texto

Crie e confirme no terminal

Agora, execute no repositório

Com a base conferida, crie a branch ajuste-texto, um nome novo nesta prática. Depois, execute a conferência separadamente.

1. Crie a branch e entre nela

bash
git switch -c ajuste-texto

2. Confira a branch atual

bash
git branch

Dica

Nova branch, mesma versão inicial

Procure * ajuste-texto na listagem. A principal continua aparecendo com seu nome original, agora sem o asterisco. As duas branches ainda apontam para o mesmo commit: criar a branch não cria um commit nem uma nova versão dos arquivos. Deixe ajuste-texto ativa para a próxima etapa.

Interprete a conferência

O que mudou até aqui?

A criação foi concluída, e git branch mostra * ajuste-texto. Você ainda não editou arquivos nem fez commits. Qual conclusão está correta?

Passo 5 de 7

Registrar mudanças na branch de trabalho

Registre uma pequena mudança e reúna evidências da branch correta, do novo commit e da ausência de pendências.

Confirme onde vai trabalhar

Continue no repositório de prática, na branch criada na etapa anterior. Antes de editar, confirme a branch ativa e o estado dos arquivos:

Confira o ponto de partida

bash
git branch
git status

Dica

Condição para continuar

O asterisco deve estar ao lado da branch de trabalho, e o status deve indicar ausência de alterações pendentes. Se o resultado for diferente, interrompa a prática para conferir o estado antes de editar.

Registre uma pequena mudança

Edite um arquivo de prática

Escolha um arquivo de texto fictício já versionado e acrescente a linha: “Descrição revisada na branch de trabalho.” Salve o arquivo.

Nos comandos abaixo, usamos descricao.txt; substitua pelo caminho do seu arquivo. Execute uma linha por vez: confira a edição antes de prepará-la e depois revise o conteúdo preparado.

Confira e prepare

bash
git diff
git add descricao.txt
git diff --staged

Confirme novamente a branch antes de registrar. Só execute o commit se a branch de trabalho estiver ativa e o conteúdo preparado contiver apenas a mudança pretendida.

Confirme e registre

bash
git branch
git commit -m "Revisa descrição do projeto"

Confira o resultado

Verifique o histórico e as pendências

bash
git log --oneline
git status

Duas verificações

No histórico, localize o novo commit pela mensagem e anote seu identificador abreviado. No status, confirme que não restaram alterações pendentes.

Se ainda houver pendências, confira o conteúdo antes de continuar: a criação de um commit, sozinha, não garante que todo o trabalho foi registrado.

Dica

Qual referência avançou?

Neste fluxo, a branch de trabalho passou a apontar para o novo commit. A principal permaneceu no commit de partida: registrar a mudança aqui não moveu a referência dela.

Apresente suas evidências

A mudança ficou na branch certa?

Registre os resultados da sua prática:

  1. O nome marcado com asterisco em git branch antes do commit.
  2. O identificador e a mensagem do novo commit em git log --oneline.
  3. O estado indicado pelo git status após o commit.
  4. O que aconteceu com a referência da branch principal.

Se alguma conferência falhou, relate o que encontrou em vez de considerar o trabalho concluído.

Escreva pelo menos 40 caracteres (0/40).

Passo 6 de 7

Alternar e conferir os arquivos

Alterne entre a principal e ajuste-texto, conferindo os arquivos e a preservação do commit registrado.

Visitar a principal

Alternar não é criar

Continue em ajuste-texto, usando o mesmo arquivo e o identificador do commit anotado na etapa anterior. git switch <branch-existente> alterna sem criar: não use -c. Com o estado limpo, os arquivos versionados passam a refletir a versão registrada na branch de destino.

Confira o ponto de partida

bash
git branch
git status

Confirme * ajuste-texto e ausência de pendências. Se houver pendências, pare. Abaixo, substitua <nome-da-principal> inteiro, incluindo os sinais < e >, pelo nome real da principal. Execute um comando por vez. Depois, confira o asterisco na principal e abra o mesmo arquivo: a mudança exclusiva não aparece nele, e o commit anotado não aparece nesse histórico.

Troque e confira

bash
git switch <nome-da-principal>
git branch
git log --oneline

Relacionar comandos e resultados

O que muda em cada caso?

Relacione cada situação ao resultado esperado. Considere o estado limpo e a mudança registrada somente em ajuste-texto.

Toque em um item e depois no par correspondente.

Voltar e encontrar a mudança

O commit não foi apagado

Sem editar arquivos na principal, confira o estado e volte. Execute um comando por vez; só prossiga com a troca se o estado continuar sem pendências.

Retorne a ajuste-texto

bash
git status
git switch ajuste-texto
git branch
git log --oneline

Confira as três evidências

Localize * ajuste-texto, abra o mesmo arquivo para ver a mudança reaparecer e encontre o identificador do commit anotado. A alternância mudou o conteúdo visível, não apagou o trabalho registrado.

Atenção

Se a troca for recusada

Pare a sequência. Confira novamente git status e git branch; use os comandos de diff conhecidos se precisar examinar as pendências. Preserve os arquivos e não force a operação.

Decidir diante de uma recusa

A troca não aconteceu

Ao tentar sair de ajuste-texto, o Git recusa a troca porque alterações pendentes seriam sobrescritas. Qual é a próxima ação segura?

Passo 7 de 7

Aplicar o fluxo seguro do início ao fim

Organize o fluxo completo, aplique os comandos em um cenário de prática e decida como agir diante de alterações pendentes.

Organize o fluxo

Da verificação à comparação

Você vai desenvolver uma mudança a partir da principal e depois comparar as versões. Considere que as verificações de estado não encontram pendências. Coloque as etapas na sequência segura.

  1. Visitar a principal e retornar à branch de trabalho, conferindo branch, arquivo e histórico em cada destino e o estado antes de cada troca.
  2. Editar o arquivo na branch de trabalho, revisar, preparar e fazer o commit.
  3. Criar a branch de trabalho com git switch -c <nova-branch> e confirmá-la com git branch.
  4. Confirmar o nome da principal nas orientações do projeto e identificar a branch atual com git branch.
  5. Verificar git status; sem pendências, ir para a principal, se necessário, e confirmar a branch ativa.
  6. Conferir o commit com git log --oneline e confirmar o estado limpo com git status.

Aplique em um projeto de prática

Cenário do desafio

Considere este repositório fictício:

  • As orientações do projeto definem estavel como a branch principal.
  • Você está em estavel, sem alterações pendentes.
  • O arquivo versionado aviso.txt contém apenas Bem-vindo!.
  • A branch ajuste-aviso ainda não existe.

Sua tarefa é adicionar a segunda linha Confira as novidades. e registrá-la somente em ajuste-aviso.

Monte seu roteiro

Descreva como criar e confirmar ajuste-aviso, registrar a mudança nela e visitar estavel antes de retornar. Inclua os comandos de criação, troca e conferência; você pode resumir o fluxo de commit já conhecido. O que deve aparecer no arquivo em cada branch? Por que o commit continua preservado?

Escreva pelo menos 40 caracteres (0/40).

Decida diante de uma pendência

E se o estado não estiver limpo?

Antes de voltar para estavel, você percebe outra edição não commitada em ajuste-aviso. A frase está incompleta e você ainda não sabe em qual branch ela deve ficar. Qual é a decisão segura?

Confira os critérios de sucesso

Resumo

O fluxo está completo quando…

Use estes critérios para conferir sua próxima prática:

  • Você identifica a branch atual e confirma a principal nas orientações do projeto, sem presumir que ela se chama main.
  • A nova branch nasce da base correta, e a mudança é commitada na branch de trabalho confirmada.
  • Antes de alternar, você verifica pendências e interrompe o fluxo se precisar definir o destino do trabalho.
  • A principal mantém sua versão; ao retornar à branch de trabalho, você encontra a mudança e seu commit preservados.

Tutorial concluído

Parabéns! Você concluiu: Criar e alternar branches com segurança

Você concluiu “Criar e alternar branches com segurança”. Leve esta rotina para a prática: conferir a base, registrar na branch certa e verificar antes de alternar — sem descartar alterações nem forçar a troca.

Baixe o Aplicativo agora para ter acesso a + de 5000 cursos gratuitos, exercícios, certificado e muito conteúdo sem pagar nada!

  • Cursos online 100% gratuitos do início ao fim

    Milhares de cursos online em vídeo, ebooks e áudiobooks.

  • Mais de 60 mil exercícios gratuitos

    Para testar seus conhecimentos no decorrer dos cursos online

  • Certificado Digital gratuito válido em todo o Brasil

    Gerado diretamente na galeria de fotos do seu celular e enviado ao seu e-mail

Aplicativo Cursa na tela de ebook, na tela de curso em vídeo e na tela de exercícios do curso, mais o certificado de conclusão de curso