Guide des conventions de nommage pour développeurs
La façon dont vous nommez vos variables, vos fonctions et vos fichiers peut sembler une affaire de goût, mais c'est en réalité une règle qui façonne la productivité de votre équipe et la lisibilité de votre code.
Pourquoi les conventions de nommage sont importantes
Le code est lu bien plus souvent qu'il n'est écrit. Une convention de nommage cohérente aide les autres, et votre futur vous-même, à comprendre le code rapidement.
Lorsque les règles sont uniformes, un nom à lui seul indique s'il s'agit d'une variable, d'une constante ou d'une classe, ce qui réduit les recherches inutiles.
Les principaux formats en un coup d'œil
- camelCase — premier mot en minuscule, première lettre des mots suivants en majuscule (myVariableName)
- PascalCase — première lettre de chaque mot en majuscule (MyClassName)
- snake_case — tout en minuscule, mots reliés par des traits de soulignement (my_variable_name)
- CONSTANT_CASE — tout en majuscule avec des traits de soulignement, généralement pour les constantes (MAX_COUNT)
- kebab-case — tout en minuscule avec des traits d'union, généralement pour les URL et le CSS (my-class-name)
Conventions selon le langage et le contexte
De nombreux langages recommandent leurs propres conventions. Python privilégie snake_case pour les variables et les fonctions, JavaScript et Java utilisent camelCase, et la plupart des langages utilisent PascalCase pour les noms de classes.
Les constantes s'écrivent souvent en CONSTANT_CASE quel que soit le langage, et kebab-case est de fait la norme pour les chemins d'URL et les classes CSS.
La cohérence compte plus que la règle
Aucun format n'est absolument correct. Ce qui compte le plus, c'est de suivre de manière cohérente la règle sur laquelle votre projet ou votre équipe s'est mis d'accord.
Lorsque vous rejoignez une base de code existante, préférez ses conventions à vos goûts personnels. Si vous devez renommer de nombreux identifiants d'un coup, un convertisseur de casse est utile.