Comment nommer les variables : Guide pour un code propre et lisible

Le nommage des variables est la décision de conception la plus fréquente d'un programmeur. De bons noms rendent le code autodocumenté ; de mauvais noms forcent les lecteurs à déchiffrer votre logique.

Principes fondamentaux

• Révéler l'intention : elapsedTimeInDays et non d
• Éviter la désinformation : Ne nommez pas accountList quelque chose qui est en fait un set
• Utiliser des noms prononçables : generationTimestamp et non genymdhms
• Utiliser des noms recherchables : MAX_STUDENTS_PER_CLASS et non 7

Patterns de nommage par type

Type	Pattern	Exemples
Boolean	is/has/can/should + adjectif	isActive, hasPermission
Compteur	nom + Count/Total	retryCount, totalItems
Collection	Nom au pluriel	users, selectedItems
Fonction	verbe + nom	calculateTotal, fetchUser
Event handler	handle/on + événement	handleClick, onSubmit

Anti-patterns

• data, info, temp, stuff — trop vagues
• a, b, x — acceptables uniquement dans les lambdas et formules mathématiques
• flag — flag de quoi ? Utilisez isEnabled à la place
• Notation hongroise (strName, intAge) — obsolète avec les IDEs modernes

Formatez vos noms

Utilisez le convertisseur camelCase pour les variables JavaScript, le convertisseur snake_case pour Python, ou le hub de conversion de casse.