Pourquoi Python n'a-t-il pas de commentaires multilignes ?

Question

OK, je suis conscient que les chaînes de caractères entre guillemets peuvent servir de commentaires multilignes. Par exemple,

"""Hello, I am a 
   multiline comment"""

et

'''Hello, I am a 
   multiline comment'''

Mais techniquement parlant, ce sont des cordes, non ?

J'ai fait des recherches sur Internet et lu le guide de style Python, mais je n'ai pas pu trouver de réponse technique à la question de savoir pourquoi il n'y a pas d'implémentation formelle des commentaires multilignes de type /* */. Je n'ai aucun problème à utiliser des guillemets triples, mais je suis un peu curieux de savoir ce qui a conduit à cette décision de conception.

Answer 1

Je doute que vous obteniez une meilleure réponse que "Guido n'a pas ressenti le besoin d'avoir des commentaires sur plusieurs lignes".

Guido a a tweeté à ce sujet,

Astuce Python : Vous pouvez utiliser des chaînes de caractères multi-lignes comme des commentaires multi-lignes. Sauf si elles sont utilisées comme docstrings, elles ne génèrent aucun code ! :-)

Answer 2

Les commentaires de plusieurs lignes sont facilement cassables. Que se passe-t-il si vous avez ce qui suit dans un simple programme de calculatrice ?

operation = ''
print("Pick an operation:  +-*/")
# Get user input here

Essayez de commenter cela avec un commentaire de plusieurs lignes :

/*
operation = ''
print("Pick an operation:  +-*/")
# Get user input here
*/

Oups, votre chaîne contient le délimiteur de fin de commentaire.

Answer 3

Les textes entre guillemets ne doivent PAS être considérés comme des commentaires multilignes ; par convention, ils sont docstrings . Ils doivent décrire ce que fait votre code et comment l'utiliser, mais pas pour des choses comme commenter des blocs de code.

Selon Guido, les commentaires multilignes en Python ne sont que des commentaires monolignes contigus (rechercher "bloquer les commentaires").

Pour commenter des blocs de code, j'utilise parfois le modèle suivant :

if False:
    # A bunch of code

Answer 4

Cela remonte probablement au concept de base selon lequel il ne doit y avoir qu'une seule façon évidente d'effectuer une tâche. Des styles de commentaires supplémentaires ajoutent des complications inutiles et peuvent réduire la lisibilité.

Answer 5

Les guillemets sont utilisés comme commentaires multilignes dans les docstrings. Et les commentaires # sont utilisés comme des commentaires en ligne et les gens s'y habituent.

La plupart des langages script n'ont pas non plus de commentaires multilignes. C'est peut-être la cause ?

Voir PEP 0008 , section Commentaires

Et voyez si votre éditeur Python offre un raccourci clavier pour commenter les blocs. Emacs le supporte, ainsi qu'Eclipse, et probablement la plupart des IDEs décents.