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#
| Convention | Exemple | Utilisation courante |
|---|---|---|
| camelCase | customerName | Variables et fonctions en JavaScript, TypeScript et Java |
| PascalCase | CustomerProfile | Classes en Python, Java, C# et TypeScript |
| snake_case | customer_name | Variables et fonctions Python, colonnes SQL, Rust |
| kebab-case | customer-profile | URLs, fichiers web, classes CSS |
| UPPER_SNAKE_CASE | MAX_RETRIES | Constantes 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.