Leçon 2 : Le principe fondamental : la lisibilité d'abord
La clarté est la pierre angulaire du Vibe Coding. Le code est lu bien plus souvent qu'il n'est écrit. Par conséquent, optimiser pour la compréhension du lecteur est primordial.
Le piège du code trop « malin »
Les débutants tentent souvent d'écrire du code très compact et « ingénieux », en utilisant des fonctionnalités complexes du langage ou une logique excessivement imbriquée pour démontrer leurs prouesses techniques. Cela crée généralement un très mauvais vibe.
Règle : Chaque fois que vous écrivez du code qui nécessite un commentaire immédiat pour expliquer ce qu'il fait, vous avez probablement échoué au test d'élégance.
La clarté plutôt que la densité
Bien que nous ne prônions pas le code boursouflé, nous privilégions des noms de variables clairs et un flux de contrôle simple, même si cela ajoute quelques lignes supplémentaires.
| Mauvais Vibe (Trop complexe) | Bon Vibe (Clair) |
|---|---|
| js | |
| const users = data.filter(u => u.a && u.b).map(u => ({ id: u.c })); | |
| js | |
| const activeAndVerifiedUsers = data.filter(user => user.isActive && user.isVerified); | |
| const userIds = activeAndVerifiedUsers.map(user => ({ id: user.userId })); | |
Techniques pour une clarté immédiate
- Introduire des variables explicatives : Si un calcul ou une condition complexe existe, stockez le résultat dans une variable avec un nom descriptif.
- Éviter l'imbrication profonde : Si vous avez plus de trois niveaux d'indentation (boucles ou conditions), envisagez de diviser la logique en fonctions distinctes.
python
Mauvais Vibe : Imbrication profonde et vérifications complexes
if condition_a: if condition_b: for item in list: if item.type == 'critical': # ... six lignes de logique
python
Bon Vibe : Encapsuler la complexité
def process_critical_items(items): # ... six lignes de logique pass
if is_valid_transaction(condition_a, condition_b): for item in list: if item.type == 'critical': process_critical_items(item)