Conventions de nommage en programmation : Le guide complet
Les conventions de nommage sont des règles systématiques pour choisir les identifiants dans le code source. La bonne convention améliore la lisibilité, réduit les bugs et facilite la maintenance entre équipes.
Pourquoi les conventions importent
Le code est lu bien plus souvent qu'il n'est écrit. Un nommage cohérent permet aux développeurs de comprendre le but et la portée d'une variable, fonction ou classe d'un coup d'œil.
Les principales conventions
camelCase
Mots joints sans séparateur, majuscule à partir du deuxième : getUserName, totalPrice. Standard pour les variables et fonctions en JavaScript, TypeScript, Java et Swift.
PascalCase (UpperCamelCase)
Comme camelCase mais le premier mot aussi en majuscule : UserAccount, HttpClient. Pour les noms de classes, composants React et interfaces TypeScript.
snake_case
Underscores comme séparateur, tout en minuscules : user_name, get_total_price. Imposé par PEP 8 pour Python, aussi standard en Ruby, Rust et SQL.
SCREAMING_SNAKE_CASE
Tout en majuscules avec underscores : MAX_RETRY_COUNT, API_BASE_URL. Pour les constantes et variables d'environnement.
kebab-case
Tirets comme séparateur, tout en minuscules : my-component, user-profile. Standard pour les classes CSS, attributs HTML, slugs d'URL et flags CLI.
Convention par langage
| Langage | Variables/Fonctions | Classes | Constantes |
|---|---|---|---|
| JavaScript / TypeScript | camelCase | PascalCase | SCREAMING_SNAKE |
| Python | snake_case | PascalCase | SCREAMING_SNAKE |
| Java | camelCase | PascalCase | SCREAMING_SNAKE |
| Ruby | snake_case | PascalCase | SCREAMING_SNAKE |
| Rust | snake_case | PascalCase | SCREAMING_SNAKE |
| Go | camelCase | PascalCase | camelCase / PascalCase |
| C# | camelCase | PascalCase | PascalCase |
| Swift | camelCase | PascalCase | camelCase |
| PHP | camelCase / snake_case | PascalCase | SCREAMING_SNAKE |
| CSS | kebab-case | — | — |
Bonnes pratiques
- Suivez le guide de style de votre langage. PEP 8 pour Python, Google Style pour Java, Airbnb pour JavaScript — n'inventez pas vos propres règles.
- Soyez cohérent dans le projet. Mélanger camelCase et snake_case dans le même fichier sème la confusion.
- Utilisez des noms descriptifs.
getUserByIdplutôt quegetU. La convention est le format ; le contenu doit être significatif. - Évitez les abréviations.
calculateTotalPriceplutôt quecalcTotPrc. - Adaptez-vous à l'écosystème. Si votre projet React utilise des props en camelCase mais votre API Python renvoie du snake_case, convertissez à la frontière.
Conclusion
Les conventions de nommage ne sont pas arbitraires. Elles encodent des informations sur la portée, le type et l'intention. Apprenez le standard de votre langage, appliquez-le systématiquement, et votre code sera plus facile à lire, à relire et à maintenir.
Convertir entre conventions
Utilisez notre convertisseur camelCase, convertisseur snake_case, convertisseur PascalCase ou convertisseur kebab-case. Ou essayez le hub de conversion de casse pour comparer tous les formats côte à côte.