Git & Version Control

Vérifier un nom de branche Gitavec les positions des erreurs

Examinez un nom de branche, une référence ou un identifiant d’objet, sans confondre syntaxe et conseils de nommage.

Vérifier un nom de branche Git

Nom ou hash à vérifier

Rapport de vérification

Saisissez un nom ou un hash.

Le texte est vérifié dans le navigateur, sans envoi de la saisie ni accès à un dépôt.

Options de vérification

Une valeur, au plus 4 096 unités UTF-16. Diagnostics affichés par groupes de 50.

Saisissez un nom ou un hash.

Vérifier un nom de branche Git permet de comprendre un refus que le terminal explique mal. Une espace collée par inadvertance, un point en début de composant ou le suffixe .lock peuvent rendre un nom inutilisable sans que la cause saute aux yeux.

Le contexte compte autant que les caractères. main est un nom de branche possible, mais une référence simple exige une option particulière. Une suite de quarante chiffres hexadécimaux peut aussi être un identifiant complet ou une abréviation selon le format choisi.

Vérifier un nom de branche Git sans perdre l’original

Localiser avant de renommer

Vérifier un nom de branche Git ne nécessite pas de réécrire votre saisie. Chaque diagnostic indique sa position ; une proposition ASCII reste dans un champ distinct. Vous pouvez juger le changement de sens avant de reprendre cette proposition dans votre propre travail.

Un élément fautif dans une suite de fragments est relié à une carte de diagnostic séparée

Afficher un préfixe sans affirmer son unicité

Un hash court rend une note de version plus lisible, mais plusieurs objets peuvent partager ce début. Le rapport distingue forme complète et abréviation. Il reprend uniquement les caractères présents et ne reconstitue jamais une fin manquante.

Le début d’une longue suite est copié vers une suite courte, avec un état de dépôt laissé inconnu

Choisir le sens de la saisie avant de conclure

01

Comparer branche et référence

Changer de mode conserve le texte. Essayez main comme branche et refs/heads/main comme référence. L’autorisation des références à un seul niveau retire uniquement l’obligation du séparateur.

  • Les autres contraintes, dont les points finaux et les doubles barres obliques, restent actives.
02

Définir le format du hash

SHA-1 comporte 40 caractères pour une forme complète, SHA-256 en comporte 64. Avec les abréviations autorisées, une longueur de 4 à la longueur complète moins 1 est classée comme abrégée.

  • L’affichage initial de sept caractères ne complète pas une saisie plus courte avec des zéros.
03

Relire le rapport après chaque changement

Le contrôle automatique attend 350 ms. Désactivez-le pour afficher le bouton manuel, ou utilisez Ctrl/Cmd + Enter. Un clic sur un diagnostic rejoint sa ligne et sa colonne.

  • Tout changement verrouille les exports ; un rapport terminé contenant des erreurs reste exportable pour examen.

Trois contextes et des résultats explicites

Un nom de branche valide selon Git

Les branches ont des contraintes supplémentaires : HEAD et le tiret initial sont interdits. Une référence Git peut être à un seul niveau si vous le permettez. La logique suit git check-ref-format sur les noms littéraux sans résoudre l’historique des changements de branche.

Des positions pour les caractères spéciaux

Le rapport repère les contrôles ASCII, espaces, ponctuations interdites et suites .. ou @{. Chaque composant est vérifié pour le point initial et la terminaison .lock. Les lignes et colonnes commencent à 1 ; les colonnes et offsets JSON comptent les unités UTF-16.

Une proposition indépendante

Le générateur utilise des lettres ASCII minuscules, des chiffres et ._-/ ; il remplace les autres caractères par des tirets, corrige les structures interdites puis recontrôle le résultat. Il ne translittère pas les autres écritures. Sans lettres ni chiffres récupérables, il propose branch.

Une interprétation explicite des identifiants

Le rapport conserve l’algorithme, la longueur, le type complet ou abrégé et le préfixe affiché. Les chiffres hexadécimaux en majuscules restent inchangés. Quarante caractères représentent une abréviation en SHA-256. Aucun calcul sur un fichier ni conversion entre algorithmes n’est effectué.

Ce qui exige encore le dépôt réel

Ni existence ni type d’objet
Une forme correcte ne prouve pas qu’un commit existe, que le préfixe est unique ou que la branche peut être créée. Les collisions entre foo et foo/bar, droits d’accès, branches protégées et contraintes du système de fichiers dépendent du dépôt et de son environnement.
Un seul texte, conservé tel quel
Les espaces aux extrémités ne sont pas supprimées. Un saut de ligne est un caractère interdit, pas un séparateur de liste. Les expressions HEAD~1, main^ et @{-1}, ainsi que les refspecs avec joker, sortent du périmètre. Aucun fichier ni contenu distant par URL n’est importé.
Les recommandations ne changent pas la syntaxe
Git accepte certains symboles que le shell interprète. Les conseils ASCII et les restrictions GitHub sur le début refs/ ou les noms hexadécimaux de quarante caractères sont séparés du verdict. Les règles de nommage propres à une équipe ne sont pas appliquées ici.
Une limite de traitement, pas une règle Git
La saisie est limitée à 4 096 unités de code UTF-16. Il ne s’agit pas d’une limite universelle des noms dans Git. Les diagnostics sont présentés par groupes de 50, mais la copie et le téléchargement JSON incluent tout le rapport achevé, y compris les erreurs.
Un remplacement à confirmer dans la prévisualisation
Les exemples et l’effacement affichent le contenu cible et les nombres de caractères avant application. Une annulation restaure saisie, options et état du rapport. Une suggestion reste à copier ; elle ne garantit pas le même sens. Si elle dépasse le budget sans solution sûre, elle n’est pas proposée.

Vérifier un nom de branche Git : questions

Comment vérifier qu’un nom de branche Git est valide ?

Choisissez le mode branche pour un nom littéral. Dans votre terminal, git check-ref-format --branch peut vérifier un nom transmis comme argument correctement protégé. main et master ne sont pas interdits simplement parce qu’une équipe les protège. Une syntaxe valide ne garantit pas la réussite de la création.

Quels caractères sont interdits dans un nom de branche ?

Git interdit les contrôles ASCII, espaces, ~, ^, :, ?, *, [, et la barre oblique inverse. Il existe aussi des contraintes sur les suites de caractères et les composants. En revanche, ] et $ ne sont pas automatiquement des erreurs de syntaxe : leur utilisation dans un shell peut demander une protection adaptée.

Peut-on utiliser des points dans les noms de branche ?

Oui, mais pas au début d’un composant, à la fin du nom complet ni deux fois de suite. Ainsi a./b est accepté, alors que a/b. ne l’est pas. Une terminaison .lock est aussi interdite ; cette comparaison distingue les majuscules, donc .LOCK ne déclenche pas cette règle.

Comment la longueur d’un hash de commit court est-elle déterminée ?

Git recherche un préfixe unique dans les objets du dépôt. La longueur minimale demandée est quatre et la valeur par défaut dépend de core.abbrev. Les sept caractères de cette page sont une préférence d’affichage. L’arrivée de nouveaux objets peut rendre une ancienne abréviation ambiguë.

Comment vérifier qu’un commit existe à partir de son SHA-1 ?

Il faut interroger le dépôt concerné, par exemple avec git cat-file -e pour tester l’existence d’une expression d’objet appropriée. Vérifier qu’il s’agit d’un commit est encore une question de type. Une chaîne hexadécimale de bonne longueur ne suffit à démontrer ni existence ni nature.

Une autre question ?

Interpréter le verdict dans son contexte

Vérifier un nom de branche Git explique les contraintes du texte. Confirmez ensuite l’existence, l’unicité et les autorisations dans le dépôt où vous comptez l’utiliser.