Git est un outil essentiel pour tout développeur, mais ses débuts peuvent être déroutants. Voici les erreurs que j'ai rencontrées en apprenant Git et comment les résoudre ou les éviter.
Oublier de faire des commits réguliers
Une erreur classique est de travailler pendant des heures sans faire de commit. Résultat : un énorme commit qui mélange plusieurs fonctionnalités et rend difficile le suivi des changements.
La solution
Prendre l'habitude de faire des commits plus fréquents, idéalement après chaque petite fonctionnalité ou correction. Un bon commit devrait représenter une seule modification logique du code.
Messages de commit peu clairs
Des messages comme "fix", "update" ou "changements" ne disent rien sur ce qui a été modifié. Quand on revient sur le projet quelques semaines plus tard, impossible de savoir ce que ces commits contenaient.
Comment bien nommer ses commits
- Utiliser un verbe à l'impératif : "Ajouter", "Corriger", "Modifier"
- Être spécifique : "Corriger le bug d'affichage dans le menu" plutôt que "fix bug"
- Garder le message concis mais informatif
- Éviter les messages vagues comme "modifications" ou "update"
Ne pas vérifier l'état avant de commit
Faire un commit sans vérifier ce qui va être ajouté peut mener à inclure des fichiers indésirables ou oublier des changements importants.
Les commandes utiles
Utiliser git status pour voir l'état actuel des fichiers et
git diff pour voir exactement ce qui a changé avant de faire un commit. Ces
commandes évitent bien des surprises.
Commit de fichiers sensibles
Ajouter accidentellement des fichiers de configuration contenant des mots de passe, des clés API ou des informations personnelles au dépôt est une erreur sérieuse.
La prévention
Utiliser un fichier .gitignore dès le début du projet pour exclure les fichiers sensibles,
les dépendances (node_modules) et les fichiers générés automatiquement. Vérifier toujours ce
qu'on s'apprête à commit avec git status.
Problèmes avec les branches
Travailler directement sur la branche main/master ou oublier sur quelle branche on travaille peut créer de la confusion, surtout dans des projets d'équipe.
Utiliser les branches correctement
-
Créer une nouvelle branche pour chaque fonctionnalité :
git checkout -b nom-fonctionnalite - Vérifier régulièrement la branche active avec
git branch - Garder la branche main propre et stable
- Fusionner les branches seulement quand la fonctionnalité est terminée et testée
Conflits de fusion mal gérés
Les conflits de fusion peuvent être stressants quand on débute. Certains développeurs paniquent et annulent tout, perdant parfois du travail.
Comment gérer les conflits
Git marque clairement les zones en conflit dans les fichiers. Prendre le temps de comprendre ce que chaque version du code fait, décider quelle version garder (ou combiner les deux), puis marquer le conflit comme résolu. Tester le code après la résolution est crucial.
Oublier de pull avant de push
Travailler sur une version locale obsolète et essayer de push sans avoir récupéré les derniers changements du dépôt distant cause des problèmes de synchronisation.
La bonne habitude
Toujours faire un git pull avant de commencer à travailler pour s'assurer
d'avoir la dernière version. Faire un autre pull avant de push pour intégrer les changements
récents des autres contributeurs.
Peur d'utiliser les commandes
Beaucoup de débutants n'osent pas utiliser certaines commandes Git par peur de tout casser. Cette hésitation ralentit l'apprentissage et limite l'utilisation de Git.
S'exercer sans risque
Créer un dépôt de test pour expérimenter avec les commandes Git sans craindre de perdre du vrai travail. C'est en pratiquant qu'on devient à l'aise avec l'outil.
Ressources utiles
- La documentation officielle de Git : claire et complète
- GitHub Learning Lab : tutoriels interactifs
- Git Cheat Sheet : aide-mémoire des commandes principales
- Stack Overflow : pour trouver des solutions à des problèmes spécifiques