Localizador de Comandos Git

Como Funciona a Referência de Comandos Git

O Que a Ferramenta Faz

A Referência de Comandos Git disponibiliza uma consulta pesquisável e categorizada de comandos git comuns, organizada por fluxo de trabalho: desfazer alterações, ramificação, stashing, rebase, tagging, operações remotas e muito mais. Cada entrada mostra a sintaxe do comando, uma breve explicação do que faz e notas práticas de utilização. A pesquisa filtra as entradas em tempo real à medida que escreve, para que possa encontrar a invocação certa sem percorrer páginas de man.

Casos de Uso Comuns para Programadores

Os programadores usam esta referência quando sabem o que querem alcançar (por exemplo, desfazer o último commit mas manter as alterações em stage) mas não se lembram das flags ou do comando exatos. É particularmente útil para operações menos frequentes como rebase interativo, cherry-picking de intervalos, recuperar branches apagadas a partir do reflog ou configurar sparse checkouts. Programadores juniores usam-na como apoio à aprendizagem para descobrir comandos cuja existência desconheciam.

Formatos, Tipos ou Variantes de Dados

Os comandos estão organizados em categorias lógicas: operações básicas (add, commit, push, pull), ramificação e merge, desfazer alterações (reset, revert, checkout), stashing, rebase, tagging, gestão de remotos, log e inspeção, e operações avançadas (bisect, worktree, submodule). Cada entrada inclui o modelo do comando com argumentos de placeholder, uma descrição de uma linha e flags relevantes com os respetivos efeitos.

Erros Comuns e Casos Limite

Os comandos git podem ter efeitos destrutivos difíceis de reverter — comandos como 'git reset --hard' e 'git clean -fd' descartam permanentemente trabalho não guardado no reflog. A referência mostra padrões de utilização comuns, mas o comportamento do git pode variar consoante a configuração (merge.ff, pull.rebase) e a versão do git. Alguns comandos comportam-se de forma diferente com e sem o separador '--', sobretudo quando nomes de ficheiros colidem com nomes de branches.

Quando Usar Esta Ferramenta vs Código

Use esta referência para uma consulta rápida de comandos durante o trabalho diário de desenvolvimento, especialmente para operações que executa com pouca frequência. Para fluxos de trabalho git complexos em produção (lançamentos automatizados, gestão de merge queue, operações em monorepo), use ferramentas específicas como aliases do git, hooks do Husky ou scripts de CI que codificam a estratégia de branches da sua equipa e reduzem a probabilidade de erro humano.