↓ Aller au contenu

Conventions de nommage

··1 min

Les conventions de nommage définissent la manière d’écrire les noms des variables, fonctions, classes ou fichiers.

Elles facilitent la lecture du code et permettent de maintenir une certaine cohérence dans un projet. Chaque langage possède ses habitudes, parfois formalisées dans des guides de style.

Les principales conventions
#

ConventionExempleUtilisation courante
camelCasecustomerNameVariables et fonctions en JavaScript, TypeScript et Java
PascalCaseCustomerProfileClasses en Python, Java, C# et TypeScript
snake_casecustomer_nameVariables et fonctions Python, colonnes SQL, Rust
kebab-casecustomer-profileURLs, fichiers web, classes CSS
UPPER_SNAKE_CASEMAX_RETRIESConstantes en Python et Java, selon les conventions du projet

On rencontre également le flatcase (customerprofile), sans séparateur ni majuscule, notamment pour certains noms de packages. Il devient toutefois difficile à lire lorsque les noms s’allongent.

Quelques exemples
#

Prenons une fonction permettant de calculer un prix total.

En Python, selon la PEP 8 :

  • Variable : total_price
  • Fonction : calculate_total()
  • Classe : PriceCalculator
  • Constante : MAX_RETRIES

En SQL, on privilégie généralement le snake_case pour les tables et les colonnes : customer_orders, created_at, total_amount.

Les mots-clés peuvent être écrits en majuscules pour les distinguer des identifiants : SELECT, FROM, WHERE.

Thibault CLEMENT - Intechnia
Auteur
Thibault CLEMENT - Intechnia
Data Scientist / ML Engineer