Pourquoi les conventions de nommage comptent
Comment nommer variables, fonctions et classes dans le code ne relève pas du seul goût personnel. Une convention de nommage uniforme rend le code lisible, fluidifie la collaboration en équipe et garantit un style cohérent. Les langages ont des usages différents ; les mélanger paraît peu professionnel.
Conventions de nommage courantes
camelCase
Le premier mot en minuscules, les mots suivants avec une initiale majuscule :
firstName
lastName
getUserInfo
isLoggedIn
Usage : variables et fonctions JavaScript/TypeScript, méthodes et variables Java, méthodes et variables C#.
PascalCase / UpperCamelCase
Chaque mot commence par une majuscule :
FirstName
UserService
HomeController
Usage : classes et interfaces JavaScript/TypeScript, classes Java, classes et méthodes C#, composants React.
snake_case
Tous les mots en minuscules, séparés par un souligné :
first_name
last_name
get_user_info
Usage : variables et fonctions Python, variables et méthodes Ruby, noms de champs en base de données, variables PHP.
UPPER_SNAKE_CASE / SCREAMING_SNAKE_CASE
Tout en majuscules, séparé par un souligné :
MAX_RETRY
DEFAULT_TIMEOUT
API_BASE_URL
Usage : constantes, options de configuration, valeurs d'énumération. Presque tous les langages utilisent cette convention pour nommer les constantes.
kebab-case
Tout en minuscules, séparé par un trait d'union :
first-name
user-profile
api-key
Usage : chemins d'URL, noms de classes HTML/CSS, noms de fichiers, clés de fichiers de configuration.
dot.case
Séparé par un point :
user.name
config.timeout
Usage : clés hiérarchiques de fichiers de configuration, espaces de noms.
Aide-mémoire des usages par langage
JavaScript / TypeScript
- Variables, fonctions : camelCase (getUserInfo)
- Classes, interfaces, types : PascalCase (UserService)
- Constantes : UPPER_SNAKE_CASE (MAX_RETRY)
- Membres privés : préfixe souligné camelCase (_privateVar)
Python
- Variables, fonctions : snake_case (get_user_info)
- Classes : PascalCase (UserService)
- Constantes : UPPER_SNAKE_CASE (MAX_RETRY)
- Membres privés : préfixe souligné snake_case (_private_var)
Java
- Variables, méthodes : camelCase (getUserInfo)
- Classes : PascalCase (UserService)
- Constantes : UPPER_SNAKE_CASE (MAX_RETRY)
- Noms de paquets : tout en minuscules (com.example.service)
CSS / HTML
- Noms de classes : kebab-case (user-profile)
- ID : kebab-case ou camelCase (choix d'équipe)
Base de données
- Noms de tables, de champs : snake_case (user_name)
- camelCase aussi utilisé, selon la convention d'équipe
URL
- Chemins : kebab-case (/user-profile/settings)
- Paramètres de requête : camelCase ou snake_case (?userId=123 ou ?user_id=123)
Règles de conversion
camelCase → snake_case
- Repérer les majuscules
- Insérer un souligné avant la majuscule
- Tout passer en minuscules
Exemple : getUserInfo → get_user_info
snake_case → camelCase
- Repérer les soulignés
- Mettre en majuscule la lettre qui suit le souligné
- Supprimer le souligné
Exemple : get_user_info → getUserInfo
PascalCase → camelCase
Passer l'initiale en minuscule, le reste inchangé.
Exemple : UserService → userService
camelCase → PascalCase
Passer l'initiale en majuscule, le reste inchangé.
Exemple : userService → UserService
kebab-case → camelCase
- Repérer les traits d'union
- Mettre en majuscule la lettre qui suit le trait d'union
- Supprimer le trait d'union
Exemple : user-profile → userProfile
Erreurs fréquentes
Mélange des conventions
Dans un même projet, mélanger camelCase et snake_case paraît brouillon. Choisissez une convention et tenez-vous-y.
Traitement des abréviations
Les abréviations en majuscules ?
- URL ou Url ? userId ou userID ?
- Usage : abréviations de deux lettres en majuscules (ID, URL), abréviations de trois lettres ou plus avec initiale majuscule (Http, Xml)
- L'équipe décide ; l'essentiel est la cohérence sur tout le projet
Sigles
Comment écrire HTTP, XML, URL en camelCase ?
- Recommandé : httpUrl, xmlParser (traités comme mots ordinaires)
- Autre école : HTTPUrl, XMLParser (abréviations conservées en majuscules)
- Cohérence d'équipe
Traitement des chiffres
user2name ou user2Name ?
- camelCase : user2Name (initiale majuscule après le chiffre)
- snake_case : user2_name
Convertir la casse avec DocsAll
L'outil de conversion de casse prend en charge :
- Tout en majuscules / tout en minuscules
- Initiale en majuscule
- Conversion croisée camelCase / PascalCase / snake_case / kebab-case
- Majuscule en début de phrase
Marche à suivre :
- Coller le texte
- Choisir le type de conversion
- Copier le résultat
Conversion côté navigateur, le texte n'est pas téléversé.
Résumé
Pour les conventions de nommage, retenez l'essentiel : variables et fonctions en camelCase ou snake_case (selon le langage), classes en PascalCase, constantes en majuscule avec souligné, URL en kebab-case. La cohérence d'équipe prime avant tout. L'outil de conversion de casse DocsAll s'exécute dans le navigateur, les données ne sont pas transmises.