Git & Version Control

Validar nomes de branches Gitcom a posição de cada erro

Confira um branch, uma referência ou um ID de objeto. Separe erros de sintaxe das recomendações de nomes.

Validar nomes de branches Git

Nome ou hash de entrada

Relatório de verificação

Digite um nome ou hash.

A verificação ocorre no navegador, sem enviar a entrada nem acessar um repositório.

Opções de verificação

Um valor, até 4.096 unidades UTF-16. Diagnósticos exibidos de 50 em 50.

Digite um nome ou hash.

Validar nomes de branches Git ajuda quando o terminal recusa um nome sem deixar clara a causa. Um espaço colado junto com o texto, um ponto no início de um componente ou o sufixo .lock podem passar despercebidos na primeira leitura.

Antes do resultado, escolha o significado da entrada. main pode ser um branch, mas uma referência com apenas um nível precisa de uma opção explícita. Uma sequência hexadecimal de quarenta caracteres também muda de classificação conforme o algoritmo selecionado.

Validar nomes de branches Git preservando a entrada

Localize o problema antes de renomear

Validar nomes de branches Git permite examinar as posições apontadas sem alterar o texto original. A sugestão ASCII aparece separadamente. Assim, você decide se retirar acentos, mudar maiúsculas ou substituir outros caracteres mantém o sentido desejado para o branch.

Um trecho incorreto de uma sequência de nome está destacado e ligado a um cartão de diagnóstico separado

Exiba uma parte sem prometer exclusividade

Um hash curto facilita a leitura de uma nota de versão, mas outros objetos podem começar com os mesmos caracteres. O relatório diferencia ID completo e abreviação. O prefixo é retirado somente da entrada existente, sem completar uma parte desconhecida.

O começo de uma sequência longa é copiado para uma sequência curta, com o repositório ainda não verificado

Escolha o contexto antes de interpretar o resultado

01

Compare branch e referência

A troca de modo mantém o texto. Experimente main como branch e refs/heads/main como referência. A opção de nível único retira somente a exigência de uma barra no modo de referência.

  • Um ponto final, barras repetidas e uma referência formada apenas por @ continuam inválidos.
02

Selecione o algoritmo do hash

Um ID SHA-1 completo tem 40 caracteres; um SHA-256 tem 64. Com abreviações permitidas, de 4 caracteres até um a menos que o tamanho completo representam um formato abreviado.

  • O padrão de sete caracteres para exibição não preenche uma entrada de quatro caracteres com zeros.
03

Confira o relatório atual

A verificação automática aguarda 350 ms após uma edição. Desative-a para mostrar o botão manual ou use Ctrl/Cmd + Enter. Clique no diagnóstico para ir à linha e coluna correspondentes.

  • Toda alteração bloqueia a exportação antiga. Um relatório concluído com erros pode ser exportado como registro do diagnóstico.

Nomes e identificadores com critérios próprios

Um nome de branch válido no contexto certo

Branches acrescentam restrições como HEAD e hífen inicial. Uma referência Git pode ter um só nível quando essa opção está ativa. A lógica segue git check-ref-format para nomes literais, sem expandir o histórico de checkouts.

Posições para caracteres especiais

O relatório detecta controles ASCII, espaços, símbolos proibidos e sequências como .. e @{. Cada componente é examinado quanto ao ponto inicial e ao final .lock. Linhas e colunas começam em 1; colunas e offsets JSON usam unidades de código UTF-16.

Sugestões independentes para revisão

O gerador usa letras ASCII minúsculas, números e ._-/ e substitui o restante por hifens. Depois corrige estruturas proibidas e verifica novamente o candidato. Não faz transliteração de outros alfabetos. Sem letras ou números aproveitáveis, sugere branch.

Formato de hash sem adivinhação

O relatório registra algoritmo, tamanho, forma completa ou abreviada e prefixo exibido. Letras hexadecimais maiúsculas são preservadas. Quarenta caracteres são uma abreviação em SHA-256. Não há cálculo de hash de arquivos nem conversão de IDs entre algoritmos.

Limites sem consultar o repositório

Existência e tipo não são confirmados
A sintaxe não comprova que um commit exista, que um prefixo seja único ou que seja possível criar o branch. Conflitos entre foo e foo/bar, permissões, branches protegidos e limites do sistema de arquivos precisam ser verificados no ambiente real.
Uma entrada literal, sem limpeza silenciosa
Espaços nas extremidades não são removidos. Quebras de linha são caracteres proibidos, não separadores de uma lista. HEAD~1, main^, @{-1} e refspecs com curingas estão fora do escopo. Não há importação de arquivos nem busca por URL.
Conselhos não mudam as regras do Git
Alguns caracteres aceitos pelo Git têm significado especial no shell. Recomendações ASCII e restrições do GitHub a nomes iniciados por refs/ ou compostos por quarenta dígitos hexadecimais aparecem separadas do resultado. Expressões regulares e políticas próprias da equipe não são aplicadas.
Orçamento de entrada e exportação completa
A entrada aceita até 4.096 unidades de código UTF-16. Esse é o orçamento da ferramenta, não um limite universal de nomes no Git. A tela mostra 50 diagnósticos por vez, enquanto a cópia e o download JSON incluem todo o relatório concluído, inclusive os erros.
Substituição com prévia e uma ação de desfazer
Exemplos e limpeza mostram o texto de destino e a quantidade de caracteres antes e depois da mudança. Aplicar substitui a entrada; desfazer restaura entrada, opções e estado do relatório. O nome sugerido é apenas para copiar e não promete equivalência de sentido. Se não couber com segurança, não será truncado e apresentado como válido.

Validar nomes de branches Git: dúvidas frequentes

Como verificar se um nome de branch Git é válido?

Use o modo branch para um nome literal. No terminal, git check-ref-format --branch permite conferir um nome passado como argumento devidamente protegido. main e master não são proibidos pela sintaxe só porque uma equipe costuma protegê-los. O resultado válido não garante que a criação terá sucesso.

Quais caracteres são proibidos em um nome de branch?

O Git proíbe controles ASCII, espaços, ~, ^, :, ?, *, [ e barra invertida. Também há restrições para sequências e componentes. Já ] e $ não representam automaticamente um erro de sintaxe. O shell pode exigir aspas ou outra forma de proteção para tratá-los como texto literal.

Posso usar pontos em nomes de branches?

Sim, com restrições de posição. Um ponto não pode iniciar um componente, terminar o nome completo nem formar dois pontos consecutivos. a./b é aceito, mas a/b. não. A terminação .lock também é proibida, com distinção entre maiúsculas e minúsculas; .LOCK não aciona essa regra.

Como é definido o tamanho de um hash curto de commit?

O Git procura um prefixo único entre os objetos do repositório. O tamanho mínimo solicitado é quatro e o padrão depende de core.abbrev. Os sete caracteres desta página são apenas uma preferência de exibição. Novos objetos podem tornar ambígua uma abreviação que antes era suficiente.

Como verificar pelo SHA-1 se um commit existe no repositório?

É preciso consultar o repositório de destino. Por exemplo, git cat-file -e verifica a existência de uma expressão de objeto adequada; saber se é um commit exige considerar o tipo. Uma sequência hexadecimal com o tamanho esperado não comprova a existência de um objeto.

Ficou alguma dúvida?

Leve o resultado ao contexto real

Validar nomes de branches Git esclarece a escrita do nome. Confirme a existência, a unicidade e as permissões no repositório em que ele será usado.