Como já vimos anteriormente, é possível inserir comentários em Python, aliás como acontece na generalidade das linguagens de programação. Os comentários são formas de incluir informação destinada ao programador, ajudando-o a orientar-se no código e a lembrar-se de qual o objetivo de uma instrução ou bloco de instruções. Outra das utilizações dos comentários é a de desativar instruções ou blocos de instruções. Como os comentários se destinam ao programador são ignorados pelo interpretador. Com conta-peso-e-medida os comentários são considerados uma boa prática e, por isso, estimulado o seu uso.
No entanto, os comentários em Python usam marcas bastante diferentes de outras linguagens. Existem 2 formas de comentar: comentar uma linha ou parte dela e comentar um conjunto de linhas (bloco).
Exemplo (comentários de uma linha ou parte de uma linha):
# Exemplo de um programa com comentários
print("Esta instrução não está comentada") # Esta instrução será executada
#print("Esta instrução está comentada")
Esta instrução não está comentada
Note-se que:
a saída do programa é apenas «Esta instrução não está comentada»;
a segunda instrução, como está comentada, não produz qualquer efeito;
podemos comentar parte da linha, sendo que a partir do sinal # nada será interpretado pelo Python;
podemos incluir as linhas em branco que quisermos para organizarmos melhor o programa.
Exemplo (comentários de uma conjunto de linhas/bloco):
'''
print("Estou dentro de um comentário")
print("Também estou dentro do comentário")
'''
print("Estou fora do comentário")
Estou fora do comentário
Note-se que as linhas entre ''' (3 aspas simples) estão comentadas.