À quoi sert le paramètre -u lors d'un git push ?
Dans la majorité des documentation, on peut lire la commande "git push -u origin master", mais quelle est l'utilité de ce paramètre ?

Améliorez vos compétences en dev !
Des cours complets, créés par des experts, pour tous niveaux et accessibles en illimité grâce à notre abonnement !
19,99€/mois

Si vous avez déjà lu de la documentation, des tutoriels ou des cours sur Git pour apprendre à pousser votre code sur un dépôt distant, alors vous avez sûrement vu cette commande quelque part :
git push -u origin master
Vous devez être habitué.e à la commande push, mais vous aurez aussi sûrement remarqué ce paramètre -u souvent présent et pourtant optionnel.
Alors pourquoi doit-on l'ajouter ? Quand le faire et surtout quelle est sont utilité ? C'est ce que nous allons voir dans cet article.
Un paramètre optionnel mais recommandé
Commençons d'abord par la signification de ce paramètre qui est en réalité un paramètre raccourci.
"-u" remplace le paramètre "--set-upstream" lors de l'appel à la commande git push, sans aucun changement entre les deux paramètres.
Que signifie "set-upstream" ?
Lorsque l'on pousse les modifications d'un dépôt local vers un dépôt distant, Git ne peut pas deviner que votre branche locale souhaite être liée par défaut avec une branche en particulier.
Cette branche distante, avec laquelle vous pouvez "lier" votre branche locale, c'est ce qu'on appelle "l'upstream".
Est-il possible de travailler sans upstream ? La réponse est : oui. Néanmoins cela ne vous facilite pas la tâche.
Que signifie lier une branche ?
Définir un upstream pour votre actuelle signifie simplement que vous n'aurez pas à indiquer le nom de la branche souhaitée à chaque fois que vous voudrez faire un git pull ou un git push.
C'est pour cela qu'il est conseillé d'utiliser le paramètre -u lorsque vous poussez une nouvelle branche sur votre dépôt distant :
git push -u origin branch
# vous pourrez ensuite simplement faire
git push origin
# ou
git pull origin
# sans spécifier la branche !
J'espère que cet article vous aura été utile, et à bientôt sur le blog !
Les articles les plus populaires du blog
Envie de continuer à lire des articles autour du développement web (entre autres) ? Voici la sélection des articles de mon blog les plus lus par la communauté !
Voir la sélection 🚀Recevez les articles de la semaine par e-mail pour ne rien manquer !
S'abonner à la newsletter 📧
À propos de l'auteur
Hello, je suis Nicolas Brondin-Bernard, ingénieur web indépendant depuis 2015 passionné par le partage d'expériences et de connaissances.
Aujourd'hui je suis aussi formateur/coach pour développeurs web juniors, tu peux me contacter sur nicolas@brondin.com, sur mon site ou devenir membre de ma newsletter pour ne jamais louper le meilleur article de la semaine et être tenu au courant de mes projets !
Photo par Ashley Jurius sur Unsplash