Leçon 4 : Nommer les choses : l'impact émotionnel des bons identifiants
Le nommage est sans doute le problème le plus difficile en Vibe Coding. Un mauvais nom force le lecteur à s'arrêter, à consulter le code environnant et à faire correspondre mentalement un nom vague à sa signification réelle — un énorme gouffre à vibe.
Le Vibe des variables
Les variables doivent répondre à Ce qu'elles contiennent et Pourquoi elles le contiennent.
| Niveau de Vibe | Exemple | Problème |
|---|---|---|
| Mauvais Vibe | tmp, i, data | Trop vague. Nécessite une recherche de contexte. |
| Vibe Neutre | userList, calc | Acceptable, mais pourrait être plus clair. |
| Bon Vibe | pendingOrders, monthlyRevenueCalculation | Intention et type clairs. |
Bonnes pratiques pour nommer les variables
- Utiliser le langage métier : Si vous travaillez avec des données financières, utilisez des termes comme
assetValuationplutôt quex. - Éviter la cartographie mentale : N'utilisez pas d'abréviations à moins qu'elles ne soient universellement acceptées dans votre domaine (ex:
HTTPest correct,custAcctne l'est pas). - Spécifier les unités/le type (si nécessaire) :
userAgeInYears,timeoutMilliseconds.
Le Vibe des fonctions et des méthodes
Les fonctions doivent être nommées comme des verbes ou des phrases d'action, répondant à Ce que fait le code.
| Entité | Convention | Exemple (Bon Vibe) |
|---|---|---|
| Variables Booléennes | Is/Has/Should | isLoggedIn, hasPermission |
| Fonctions (Actions) | Verbe + Nom | fetchUserData, calculateTax |
| Classes/Objets | Nom | ShoppingCart, UserAuthenticator |
Exemple de changement de Vibe
javascript // Mauvais Vibe : Action ambiguë function handle(a, b) { // ... }
// Bon Vibe : Intention et paramètres clairs function processUserTransaction(userId, amount) { // ... }