Bonnes pratiques & outils

10.1Bien nommer ses variables

Appelle une épée une epee, pas x. Choisis des noms clairs, explicites, qui t'aident à comprendre ton propre code (même 3 jours plus tard).

// Moins clair
let x = true;

// Mieux
let potionActivee = true;

10.2Commenter (mais pas trop)

Les commentaires servent à expliquer ce qui n'est pas évident. Inutile de décrire chaque ligne banale.
Un bon commentaire = une info utile, rapide à lire.

// Mauvais : on commente tout pour rien
let niveau = 2; // on crée une variable niveau

// Mieux :
let niveau = 2; // Niveau de départ du joueur

10.3Écrire lisible (indentation & sauts de ligne)

Ton code, c'est ton terrain de jeu. S'il est tout serré, illisible, c'est comme jouer en mode ultra-brouillard. Saute des lignes entre les blocs, indente correctement… respire !

// Illisible
if(condition){jouer();avancer();}

// Lisible
if (condition) {
  jouer();
  avancer();
}

10.4Gérer les erreurs (sans paniquer)

Utilise try...catch pour éviter qu'un bug n'explose tout ton programme. Et si tu fais une appli sérieuse : affiche un message clair pour l'utilisateur.

try {
  lancerMissile();
} catch (erreur) {
  console.log("Ouf, missile désactivé :", erreur);
}

10.5Linting & formatage

Des outils comme ESLint ou Prettier sont comme des assistants :

• ✔️ Ils corrigent la mise en forme
• 🚨 Détectent des erreurs potentielles
• T'évitent de tout faire à la main

un bon moyen d'éviter les fautes de frappe et les oublis bêtes.

10.6Garder un fichier clair et structuré

Si ton fichier dépasse 200 lignes... il est peut-être temps de le découper ! Organise ton projet avec plusieurs fichiers (on verra ça avec les modules dans le chapitre suivant).

10.7Se relire (ou se faire relire)

Parfois, une faute de frappe ou une logique bancale passe inaperçue. Un petit coup d'œil frais (même le tien après une pause) peut faire toute la différence.

10.8Ne pas tout apprendre d'un coup

Tu n'es pas obligé de retenir tout ce que tu vois ici. Garde en tête que tout le monde progresse pas à pas. Mieux vaut comprendre 3 choses vraiment bien que survoler 15 notions sans les retenir.