Introduction aux commentaires et à la lisibilité du code

Les commentaires servent à expliquer le code et à le rendre plus lisible. L’interpréteur Python les ignore et ils n’ont aucun effet sur l’exécution du programme.

Dans cette leçon, vous apprendrez à utiliser les commentaires et à écrire du code propre et lisible.

Commentaires sur une seule ligne

Les commentaires sur une seule ligne commencent par un #. Tout ce qui suit le # sur cette ligne est ignoré par Python. Par exemple :

# This is a single-line comment
print("Hello, World!")

Commentaires sur plusieurs lignes

Les commentaires sur plusieurs lignes peuvent être écrits à l’aide de guillemets triples (''' ou """). Par exemple :

"""
This is a multi-line comment.
It spans multiple lines.
"""
print("Hello, World!")

Pourquoi utiliser des commentaires ?

Les commentaires sont utiles pour :

• Expliquer du code complexe.
• Rendre le code plus facile à comprendre pour les autres et pour vous-même à l’avenir.
• Déboguer le programme et résoudre les problèmes.

N’oubliez pas que les commentaires sont destinés aux humains, pas à la machine !

Bonnes pratiques pour les commentaires

Voici quelques conseils pour rédiger de bons commentaires :

• Gardez vos commentaires concis et pertinents.
• Évitez les commentaires évidents comme # Increment x by 1 pour x = x + 1.
• Utilisez les commentaires pour expliquer pourquoi le code est écrit d’une certaine manière.

Amélioration de la lisibilité du code

Un code lisible est plus facile à maintenir et à déboguer. Voici quelques conseils :

• Utilisez des noms explicites pour les variables et les fonctions.
• Gardez les lignes de code courtes.
• Organisez le code en sections à l’aide de commentaires.

Mettre du code en commentaire

Vous pouvez utiliser des commentaires pour désactiver temporairement du code à des fins de débogage. Par exemple :

# print("This line is commented out and won’t run.")
print("This line will run.")

Exemple : documenter une fonction

Vous pouvez utiliser des commentaires pour documenter des fonctions et expliquer leur objectif :

def greet(name):
    # This function greets the user by their name.
    print("Hello,", name)

greet("Alice")

Qu’avons-nous appris ?

Dans cette leçon, vous avez appris :

• Comment écrire des commentaires sur une seule ligne et sur plusieurs lignes en Python.
• L’importance des commentaires pour la lisibilité et la facilité de maintenance du code.
• Les bonnes pratiques pour écrire des commentaires et améliorer la lisibilité du code.

Excellent travail ! Passons au sujet suivant.