Retour au cours

Nommer les choses : l'impact émotionnel des bons identifiants

L'Art du Vibe Coding : Esthétique, Élégance et Intelligence Émotionnelle dans le Développement Logiciel

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 VibeExempleProblème
Mauvais Vibetmp, i, dataTrop vague. Nécessite une recherche de contexte.
Vibe NeutreuserList, calcAcceptable, mais pourrait être plus clair.
Bon VibependingOrders, monthlyRevenueCalculationIntention et type clairs.

Bonnes pratiques pour nommer les variables

  1. Utiliser le langage métier : Si vous travaillez avec des données financières, utilisez des termes comme assetValuation plutôt que x.
  2. Éviter la cartographie mentale : N'utilisez pas d'abréviations à moins qu'elles ne soient universellement acceptées dans votre domaine (ex: HTTP est correct, custAcct ne l'est pas).
  3. 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éConventionExemple (Bon Vibe)
Variables BooléennesIs/Has/ShouldisLoggedIn, hasPermission
Fonctions (Actions)Verbe + NomfetchUserData, calculateTax
Classes/ObjetsNomShoppingCart, 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) { // ... }