En Python, les commentaires sont des lignes ignorées lors de l'exécution du code. Ils ne modifient pas le programme mais servent à expliquer son fonctionnement, à laisser des notes ou à désactiver des lignes pendant les tests. Les commentaires facilitent la lecture du code, aussi bien pour les débutants que pour les développeurs expérimentés.

Commentaires sur une seule ligne

Le commentaire le plus courant en Python commence par le symbole dièse #. Tout ce qui suit sur la même ligne est ignoré par Python. Cela est utile pour expliquer le rôle d'une ligne ou d'un bloc de code.

Commentaires sur plusieurs lignes

Python ne possède pas de syntaxe spécifique pour les commentaires sur plusieurs lignes. Il est courant d'écrire plusieurs commentaires sur une seule ligne à la suite, chacun commençant par #.

Une autre option consiste à utiliser des triples guillemets (''' ou """). Ce sont des littéraux de chaîne, mais s'ils ne sont pas assignés ou utilisés comme docstrings, Python les ignore. Utiliser cette méthode avec précaution pour éviter toute confusion.

À quoi servent les commentaires

Les commentaires rendent le code plus facile à comprendre, en particulier dans les projets volumineux ou collaboratifs. Ils sont utilisés pour :

• Expliquer une logique complexe ;
• Documenter les raisons des choix effectués ;
• Identifier des sections du code ;
• Désactiver temporairement des lignes lors des tests ;
• Ajouter des notes TODO pour des améliorations futures.

Résumé

• Les commentaires sont ignorés par l'interpréteur Python ;
• Les commentaires sur une seule ligne commencent par # ;
• Les commentaires sur plusieurs lignes sont simulés en répétant # ou parfois avec des chaînes entre triples guillemets ;
• Utiliser les commentaires pour expliquer, organiser et déboguer le code.