{"canonical_url":"https://engineer.company/fr/glossary/code-quality/","content_markdown":"# Qualité du code\n\n## Ce que c'est\n\nLa qualité du code tient à la manière dont le code source réalise le comportement attendu et à la\nfacilité avec laquelle on peut le comprendre, le vérifier et le faire évoluer. Prenons une petite\nfonction de facturation. Une version obtient le bon montant pour la commande de démonstration,\nparce qu'elle suit précisément le chemin prévu par son auteur. Une autre indique la devise,\nexprime la règle d'arrondi à un seul endroit et traite les avoirs de façon explicite. Les deux\npeuvent passer le test du cas courant. Pour enquêter sur une facture contestée, la seconde offre\nun meilleur point de départ.\n\nL'exactitude se joue aussi aux limites, par exemple en cas de données invalides, de nouvelle\ntentative ou d'opération effectuée à moitié. La lisibilité se mesure à ce que la personne suivante\npeut comprendre des décisions prises. La facilité d'évolution dépend de l'étendue du prochain\nchangement et de la possibilité d'en vérifier les effets. Une fonction courte peut calculer une\ntaxe incorrecte. Une fonction complexe peut être correcte aujourd'hui et rendre très difficile\nl'ajout d'une devise demain.\n\nLa revue de code contribue à apprécier ces propriétés. Un contrôle bloquant empêche les\nchangements d'avancer quand certaines vérifications échouent. La dette technique désigne les coûts\nfuturs qu'une décision entraîne. La qualité du code est l'état du code lui-même. La règle de revue\nde Google traduit cette idée en une décision quotidienne, en demandant si chaque modification\naméliore la santé de l'ensemble du code.\n\n## Pourquoi c'est important\n\nC'est généralement une nouvelle exigence qui révèle la qualité du code. Un service produit un\ndevis, émet une facture puis établit éventuellement un avoir. Si chaque opération recalcule\nindépendamment la même remise, faire évoluer les conditions d'éligibilité oblige à trouver toutes\nles copies. Une divergence peut seulement se remarquer au moment du premier remboursement. Si une\nrègle commune est exprimée à un endroit connu et que chaque opération lui fournit ses données\nclairement, la personne qui relit le changement peut en prévoir la portée.\n\nUne preuve utile correspond à un risque. Pour les montants, on choisira un exemple où arrondir les\nlignes donne un autre résultat qu'arrondir le total. Pour une action susceptible d'être relancée,\non vérifiera si la deuxième requête déclenche un second débit. Lorsqu'un calcul est exécuté à\nchaque commande, mieux vaut mesurer le délai sous la charge attendue avant d'ajouter un cache.\nChaque observation permet une conclusion dans un périmètre précis.\n\nIl y a aussi un enjeu de transmission. Les personnes changent de projet et la personne chargée de\nla revue peut découvrir le module. Des noms précis, un exemple exécutable et une explication\ncourte d'une contrainte inhabituelle permettent de retrouver et de vérifier une décision sans\ndemander de l'aide à son auteur. Cette autonomie compte pendant une panne autant que pour intégrer\nquelqu'un à une équipe.\n\n## À quoi cela ressemble en pratique\n\nImaginons qu'une règle demande d'arrondir la taxe sur le total par taux d'imposition. Sur une\nfacture à deux lignes, la taxe brute de chacune vaut 0,005 unité monétaire. Si on arrondit chaque\nligne au centime en traitant les demis à la hausse, on obtient 0,02 au total. Si on additionne\navant d'arrondir une seule fois, on obtient 0,01. On peut refaire ce calcul à la main. L'exemple\nillustre une décision qui, pour une vraie facture, relève des exigences du produit et des règles\napplicables.\n\nLe contrat de la fonction peut préciser l'unité attendue et l'ordre des opérations. Il faut garder\nla précision requise pendant les calculs intermédiaires. Le regroupement doit rester visible et\nl'arrondi intervenir au point convenu. Un test avec les chiffres précédents distingue bien les\ndeux méthodes. Un autre peut mêler deux taux pour éviter qu'un remaniement ultérieur remplace les\ngroupes par une somme globale. Si les avoirs obéissent à une règle différente, ajoutons un exemple\npropre à cette règle.\n\nÀ la revue, suivons le montant affiché, celui qu'on exporte et celui qui sert lors du\nremboursement. Les anciennes factures gardent les montants enregistrés lors de leur émission. Un\nessai de la chaîne complète vérifie que les appels emploient les bonnes unités. Un test isolé dit\nsi le calcul fonctionne avec ses entrées, tandis que l'essai de bout en bout indique si les bonnes\nentrées lui parviennent réellement.\n\nNotre [note sur la vente du dernier billet une seule\nfois](/fr/notes/selling-limited-stock-without-overselling/) applique la même démarche à un autre\ndomaine. Elle pose une égalité que les stocks doivent toujours respecter, prévoit des tests\nconcurrents et propose de surveiller cette égalité en fonctionnement. Une personne qui relit une\nmodification peut ainsi repérer le résultat que plusieurs parcours doivent préserver.\n\n## Où les problèmes surviennent\n\nUn indicateur peut être pris pour une garantie. La couverture montre quelles lignes ou branches\nles tests ont parcourues. Si le résultat attendu traduit la mauvaise règle d'arrondi, le test peut\nréussir. Un indice de complexité aide à repérer du code à lire. Remplacer une comparaison claire\npar des appels à plusieurs fonctions peu explicites peut pourtant rendre un incident plus\ndifficile à comprendre. Avant de poser un seuil, identifions les défauts qu'il doit permettre de\ndécouvrir et examinons des exemples de part et d'autre.\n\nOn peut aussi consacrer trop de temps à un nettoyage peu important. Une fonction mal nommée dans\nun rapport occasionnel n'a pas la même portée qu'une condition floue qui s'applique à chaque\nprélèvement. Indiquons le risque constaté, les corrections requises et les améliorations qui\npeuvent attendre. Une préférence de présentation se règle souvent par une convention et un outil\nde formatage.\n\nEnfin, un changement local peut déplacer un problème ailleurs. Mutualiser les remises a du sens\nlorsque plusieurs opérations suivent la même règle commerciale. Si un remboursement et une\npromotion suivent deux politiques différentes, une fonction qui devine laquelle s'applique sera\ndifficile à relire. Commençons par préciser quels éléments coïncident. Partageons la partie stable\net rendons les différences visibles. Une autre personne doit pouvoir expliquer la règle à partir\ndu code et en vérifier le résultat.\n\n## Pour aller plus loin\n\n- [Règle de décision de Google pour la revue de\n  code](https://google.github.io/eng-practices/review/reviewer/standard.html)\n- [Ce que Google vérifie lors d'une\n  revue](https://google.github.io/eng-practices/review/reviewer/looking-for.html)\n- [Tests unitaires dans Software Engineering at\n  Google](https://abseil.io/resources/swe-book/html/ch12.html)\n\n\u003chttps://engineer.company/fr/glossary/code-quality/\u003e\n","date_modified":"2026-11-19T06:00:51Z","description":"Comment juger la qualité du code à partir de son exactitude, de sa lisibilité et de sa facilité à évoluer, puis décider quoi corriger.","formats":{"gemtext":"https://engineer.company/fr/glossary/code-quality/index.gmi","gopher":"https://engineer.company/fr/glossary/code-quality/gophermap","html":"https://engineer.company/fr/glossary/code-quality/","json":"https://engineer.company/fr/glossary/code-quality/index.json","markdown":"https://engineer.company/fr/glossary/code-quality/index.md","pdf":"https://engineer.company/fr/glossary/code-quality/index.pdf"},"kind":"page","language":"fr","title":"Qu'est-ce que la qualité du code ?","url":"https://engineer.company/fr/glossary/code-quality/","version":1}