Git cherry-pick: como aplicar um commit a outro ramo sem copiar tudo
Publicado em 2026-10-26 por frfrand
Mover uma correção pontual entre branches com Git cherry-pick
Corrigiste um bug em um branch, mas também precisa dele em produção e não quer levar todas as mudanças daquele branch. Aí aparece o git cherry-pick: pega o efeito de um ou mais commits e aplica sobre o branch atual.
A ideia é usá-lo para resolver um problema de verdade, não memorizar comandos porque ficam bem em uma captura. Vamos com o essencial, um exemplo de trabalho e os erros que mais convém evitar.
O que o Git cherry-pick faz e quando serve
Não move literalmente o objeto commit original para o outro branch: normalmente cria um commit novo com outro hash e as mudanças equivalentes. Por isso serve para backports, não para substituir uma estratégia ordenada de merge.
Se está aprendendo, teste primeiro em um repositório ou ambiente de teste. Se administra produção, documente o estado antes de executar qualquer coisa que altere arquivos, histórico ou dados. Isso permite entender o que mudou e recuperar-se se errar.
Exemplo para copiar e entender
git log --oneline -5
git switch main
git cherry-pick -x abc1234
# Si hay conflictos: resolver archivos, luego
git add .
git cherry-pick --continue
# Para abandonar la operación
git cherry-pick --abortNão copie a ordem final sem olhar o estado prévio. Os nomes de branches, host, usuário ou caminhos são exemplos; substitua-os pelos do seu projeto. Alguns comandos modificam arquivos ou fazem requisições que podem gravar dados.
Como usaria passo a passo
- Passo 1. Encontre o hash da correção com
git log --oneline. - Passo 2. Confirme que está no ramo de destino, idealmente com testes passando.
- Passo 3. Execute
git cherry-pick -x HASHse quiser deixar constância da origem na mensagem. - Passo 4. Se houver conflitos, corrija-os, revise o diff e continue; não aceite ambas as versões cegamente.
- Passo 5. Execute testes e implante somente após comprovar o comportamento.
Pare após cada passo e comprove o resultado. Se algo falhar, anote a mensagem exata antes de mudar de estratégia. Pular entre cinco soluções aleatórias costuma dificultar encontrar a causa real.
Um caso que pode acontecer trabalhando com clientes
O ramo desenvolvimento inclui redesenho do painel, mas você corrigiu um erro de validação de reservas. Em vez de mesclar o redesenho incompleto, aplica apenas o commit da validação sobre o ramo estável.
O objetivo não é que «funcione uma vez», mas que você possa explicar como repete sem comprometer outra aplicação. Se houver dados ou credenciais de clientes, trabalhe com testes separados e acessos mínimos.
O erro que mais vejo
Se o commit depende de outras alterações que não existem no destino, o cherry-pick pode falhar ou compilar com comportamento incorreto. Teste sempre as dependências e não o use para copiar dezenas de commits relacionados sem revisar.
Uma regra simples: se você não puder explicar o que o comando fará no seu código ou servidor, consulte primeiro a ajuda oficial. Assim, você evita confundir uma solução rápida com um novo problema.
Onde entra o ArduMaker?
Ao fazer deploy via Git com o ArduMaker, você pode identificar qual commit está publicado. Isso facilita corrigir um incidente com um cherry-pick e manter a revisão de produção separada do desenvolvimento incompleto.
Por exemplo, você pode fazer deploy de um repositório Git para um VPS, associar um domínio HTTPS e administrar serviços e bancos de dados no mesmo ambiente. O painel reduz tarefas repetitivas de infraestrutura, mas não substitui o Git, os testes nem a revisão de permissões do projeto.
Perguntas rápidas antes de aplicá-lo
Isso altera a produção? Depende de onde você executa a ação. Teste localmente primeiro, identifique o commit ou serviço afetado e prepare um plano de recuperação.
Como comprovar que deu certo? Não fique apenas na ausência de mensagens de erro: revise o status, execute um teste funcional e confira os logs ou o histórico correspondente.
Vale a pena automatizar? Se for repetível e tiver resultados verificáveis, sim. Mas a automação deve falhar de forma clara e não esconder erros ou credenciais.
Para ampliar
Resumo: a ferramenta útil não é a que tem mais opções, mas sim a que permite entender o que mudou, verificá-lo e continuar trabalhando sem surpresas.