5 Erreurs à Eviter lorsque vous Nommez vos Variables
Le choix des noms de variables est crucial pour la lisibilité et la maintenabilité du code. Explorez 5 erreurs courantes à éviter lors du nommage des variables en programmation.
3 min
Nommer correctement vos variables est une compétence essentielle pour écrire du code propre et lisible. Pourtant, il est facile de tomber dans certaines erreurs qui peuvent rendre votre code confus et difficile à maintenir. Dans cet article, nous allons passer en revue 5 erreurs classiques que vous devez absolument éviter.
Erreur n°1 : Nom peu explicite
Un nom peu explicite rend difficile la compréhension de la donnée stockée au sein de la variable.
temp = "azerty.jpg" // ❌ Peu clair
temporaryFile = "azerty.jpg" // ✅ Explicite
d = "2024-08-27" // ❌ Peu clair
startDate = "2024-08-27" // ✅ Explicite
Erreur n°2 : Conventions inconsistantes
Mélanger les styles de nommage dans un même projet (camelCase, snake_case, etc.) peut rendre le code plus difficile à lire et maintenir.
userName = "toto"
last_name = "tutu" // 🤯 Case non constante
Il est important de choisir une convention (en accord avec les recommandations du langage) et de s’y tenir.
Erreur n°3 : Utilisation de mots reservés
Certains mots sont réservés par les langages de programmation. C’est souvent le cas de :
classforreturnif- Etc.
Les utiliser comme noms de variables provoque des erreurs syntaxiques altérant l’interprétation du code.
class = "car" # ⚠️ "class" est un mot-clé réservé en Python
className = "car" # ✅ Pas d'usage de mot-clé réservé
Erreur n°4 : Nom trop long
Des noms de variables excessivement longs peuvent complexifier inutilement la lecture et l’écriture de votre code.
totalPriceIncludingTaxesAndDiscounts = 10 # ❌ Trop verbeux
finalPrice = 10 # ✅ Court et clair
Erreur n°5 : Caractères blacklistés
Certains caractères sont interdits dans les noms de variables par la plupart des langages de programmation comme JavaScript, PHP ou encore Python. C’est notamment le cas des :
- Chiffres en début de nom
- Caractères spéciaux (hormis le tiret du bas
_) - Espaces
1erUtilisateur = "toto" # ❌ Chiffre en début de nom
premierUtilisateur = "toto" # ✅ OK
taille_éléphant = 3.8 # ❌ Caractère spécial
taille_elephant = 3.8 # ✅ OK
ma variable = 10 # ❌ Espace
ma_variable = 10 # ✅ OK
Si chaque langage possède ses propres règles de nommage, utiliser uniquement des lettres, des chiffres et des underscores (_) est une bonne pratique à prendre.
En évitant ces erreurs courantes lors du nommage de vos variables, vous vous assurerez d’écrire un code plus propre, plus lisible et plus facile à maintenir. Prendre le temps de bien nommer vos variables est un investissement qui vous fera gagner du temps à long terme.