Aller au contenu

Les noms des variables

"Donner un bon nom à une variable, c’est écrire du code que tu comprends encore dans six mois." ✨

Bonne pratique du développeur

Les noms de variables peuvent être choisis arbitrairement. Il faut cependant respecter certaines conventions et notament les [normes] de l'ETML

Quand on crée une variable, il est essentiel de bien la nommer.
Un bon nom rend le code plus clair, plus facile à relire, et plus facile à maintenir.

Règles de base

En C#, un nom de variable :

  • ✅ doit commencer par une lettre (jamais un chiffre),
  • ✅ peut contenir des chiffres (note2, age18) ou des underscores (_temp),
  • ❌ ne peut pas contenir d’espace, ni de caractères spéciaux,
  • ❌ ne doit pas être un mot clé, réservé du langage (int, class, public, etc.),
  • ✅ est sensible à la casse (Nom ≠ nom).
  • ✅ les tableaux (ou collection) sont au pluriel.

Conventions de nommage

En C#, on suit généralement la convention camelCase pour les variables.

Convention Exemple correct À éviter (en anglais)
camelCase nbrStudents Nombre_eleves, nbeleves
Verbe pour booléens isConnected, isEnded status, done
Anglais ou français ? cohérent dans tout le projet mélange dangereux

camelCase = première lettre en minuscule, puis majuscules pour les mots suivants : maVariableLongue.

Image title

✅ Bonnes pratiques

  • Choisir des noms explicites : userAge est meilleur que a.
  • Éviter les abréviations floues : nbEtud peut être difficile à comprendre.
  • Des nom en anglais (norme ETML).
  • Ne jamais mélanger les langues (clientStatusOk + montantTotal) → 😬

❌ À éviter absolument

Mauvais nom Pourquoi ?
x, y, z Trop vague (sauf en maths ou variables de boucle)
data, info, val Trop générique
variable, test Ne dit rien sur l’objectif

Exemples

int    nbStudents = 12;        // 👍 clair
bool   isConnected = true;     // 👍 booléen commence par "is"
string usrVorname = "Alice";   // 👍 en camelCase

Quiz

Indique si chaque nom de variable est correctement écrit ou non, selon les conventions C# et les normes ETML.

1️⃣ `nombreEleves` ❌ **InCorrect** — Respecte la convention `camelCase`, mais pas en anglais !.
2️⃣ `2emePlace` ❌ **Incorrect** — Ne peut pas commencer par un chiffre.
3️⃣ `Nom_Eleve` ❌ **Incorrect** — Pas en `camelCase`, utilise un underscore au lieu de majuscule interne.
4️⃣ `isNumeric` ✅ **Correct** — Bon nom de booléen, commence par "is", clair et en `camelCase`.
5️⃣ `class` ❌ **Incorrect** — `class` est un **mot réservé** en C#, donc interdit comme nom de variable.

Navigation

Introduction Types valeur/référence Nommage Déclaration et affectation Portée (Scope)

Pour aller plus loin

🔗 Conventions de code - Microsoft#

🔗 Nom d'identificateurs

🔗 Les normes ETML