Les langages de programmation proposent une notation pour insérer des commentaires dans le code, c'est-à-dire du texte qui va être ignoré par l'ordinateur. Les commentaires peuvent servir à expliquer une partie compliquée d'un programme, ou à mettre des indications dans le code, comme son auteur ou sa date.

En Python, on insère un commentaire avec le caractère # (un dièse). Voici un exemple :

# Ce programme a été écrit par Hermione Granger le 10/01/1994
# Quatrième année, cours d'étude des moldus

# Affiche un rectangle rempli de X 
for loop in range(5):
   for loop in range(10):
      print("X", end = "")  # pas de retour à la ligne ici
   print()
   

Toutefois, la priorité est toujours d'écrire le code le plus clair possible. En effet, il est très souvent bien plus efficace de comprendre un programme directement à partir de ses instructions, qu'en alternant la lecture des instructions avec celle d'explications spécifiques. N'utilisez donc de commentaires que lorsque cela s'avère nécessaire, une fois que vous avez travaillé la clarté de votre code au maximum.

Remarque : Une variante consiste à commencer un commentaire avec trois guillemets """ et à le finir de la même façon. C'est une façon aisée d'écrire un long commentaire qui court sur plusieurs lignes :

"""
Nous rappelons la formule du produit scalaire de deux 
vecteurs que nous utilisons ci-dessous :
Soit U(x;y) et V(x';y'), U.V = x * x' + y * y'
"""
      

En réalité, il ne s'agit pas d'un commentaire mais d'un texte du programme s'étendant sur plusieurs lignes. Sans instruction pour l'utiliser, il est cependant ignoré à l'exécution.