Quand utiliser camelCase
camelCase reste compact, comme userProfileImage, et s’intègre naturellement aux écosystèmes qui l’utilisent déjà pour variables, propriétés et fonctions.
Guide des conventions de nommage
camelCase vs snake_case
camelCase supprime les séparateurs et met les mots suivants en majuscule initiale ; snake_case garde les mots en minuscules séparés par des underscores. Le bon choix dépend du langage, de l’API ou de la base de données.
Comparaison rapide
| Différence | camelCase | snake_case |
|---|---|---|
| Exemple | userProfileImage | user_profile_image |
| Usage courant | Identifiants JavaScript/TypeScript et nombreuses propriétés de style Java | Identifiants Python, colonnes de base de données, pipelines et configuration |
| Séparateur de mots | Aucun | Underscore (_) |
| Capitalisation | Premier mot minuscule, suivants capitalisés | Généralement tout en minuscules |
| Exemple avec acronyme | apiResponseUrl | api_response_url |
| Frontière typique | Frontend / modèle applicatif | Backend / API / base de données |
Quand utiliser snake_case
snake_case rend les limites de mots visibles, comme user_profile_image, et est courant en Python, SQL, data et API.
Matrice de décision
| Contexte | Convention recommandée | Pourquoi |
|---|---|---|
| Code applicatif JavaScript ou TypeScript | camelCase | Les variables, paramètres, méthodes et propriétés utilisent couramment le lower camel case dans l’écosystème JavaScript. |
| Code applicatif Python | snake_case | PEP 8 recommande les noms en minuscules séparés par des underscores pour les fonctions et variables. |
| Frontière JSON ou API HTTP | Respecter le contrat API | Gardez une convention interne unique et normalisez une seule fois à la frontière de sérialisation ou de transport. |
| Schéma de base de données ou d’analytics existant | Respecter le schéma existant | Modifier un contrat externe mature coûte généralement plus cher que s’adapter à la frontière applicative. |
Quel style de nommage choisir ?
Utilisez la convention attendue par la couche concernée. Un frontend JavaScript peut normaliser une API snake_case à la frontière ; la cohérence interne de chaque couche est prioritaire.
Erreurs fréquentes à éviter
- Ne supposez pas qu’un acronyme possède une seule forme correcte : userID, userId et user_id existent tous en pratique.
- Ne mélangez pas des données API snake_case brutes et des données camelCase normalisées dans le même modèle ou la même clé de cache.
- Ne renommez pas récursivement des instances de classe, fichiers, streams ou autres valeurs non JSON comme s’il s’agissait d’objets JSON simples.
Convertir entre conventions
Collez un identifiant pour voir le format cible et les autres conventions prises en charge. La conversion s’effectue dans votre navigateur.
Détecté : snake_case
Sortie snake_case
user_profile_image_url
Tous les formats de nommage
camelCase
userProfileImageUrlPascalCase
UserProfileImageUrlsnake_case
user_profile_image_urlkebab-case
user-profile-image-urlCONSTANT_CASE
USER_PROFILE_IMAGE_URLdot.case
user.profile.image.urlpath/case
user/profile/image/urlLa conversion s’effectue localement dans votre navigateur. Votre entrée n’est pas envoyée à un serveur de conversion.