Un commentaire est une ligne de texte que Python ignore complètement à l'exécution — il ne sert qu'à expliquer le code pour un humain qui le relit plus tard, y compris soi-même après plusieurs semaines d'oubli.

La syntaxe

Le caractère # transforme tout ce qui suit sur la même ligne en commentaire :

# Ce programme calcule le prix total d'un panier
prix_unitaire = 4.5   # prix en dollars
quantite = 3

print(prix_unitaire * quantite)

Contrairement à d'autres langages, Python n'a pas de symbole dédié pour un commentaire sur plusieurs lignes : il faut répéter # au début de chaque ligne à commenter.

Pourquoi commenter, et surtout QUOI commenter

Un commentaire utile explique le POURQUOI d'un choix, pas ce qu'une ligne fait déjà de façon évidente (x = x + 1 # on ajoute 1 à x n'apporte rien). Le meilleur moment pour commenter reste juste après avoir écrit une logique un peu subtile, pendant qu'elle est encore fraîche en tête.

Désactiver temporairement une ligne de code

Placer un # devant une ligne de code déjà écrite la désactive sans la supprimer, pratique pour tester une variante sans perdre l'original.

# print("Version de test désactivée")
print("Version actuelle")

À vous de jouer : ajoutez un commentaire au-dessus d'une ligne de calcul déjà écrite, expliquant pourquoi ce calcul est fait, pas ce qu'il fait.