Comentários em Python
Comentários são anotações dentro do código usadas para explicar o que ele faz.
O Python não executa comentários; eles servem apenas para leitura humana.
Comentário de uma linha
Use o símbolo #. Tudo após ele, na mesma linha, é ignorado pelo Python.
# Este é um comentário de uma linha
print("Olá, mundo!") # comentário ao lado do código
Comentário em várias linhas (prática comum)
O Python não tem um comando específico para bloco de comentários.
A prática é usar # em várias linhas seguidas.
# Este programa mostra uma mensagem
# na tela. Ele é simples,
# mas serve como exemplo.
print("Olá, mundo!")
Docstrings (aspas triplas)
Não são comentários, mas ajudam!
As aspas triplas (""" """ ou ''' ''') criam uma string multilinha. Se não for atribuída a nada, o Python ignora — por isso alguns usam como “comentário de bloco”.
Porém, o uso correto é documentar funções, classes e módulos (aparece no help()).
Como “comentário alternativo” (string ignorada):
"""
Texto explicativo que parece um comentário,
mas é uma string multilinha não usada.
"""
print("Olá, mundo!")
Como docstring real (documentação oficial do código):
def saudacao():
"""Esta função exibe uma saudação na tela."""
print("Olá, mundo!")
Resumo:
#→ única forma oficial de comentário.- Várias linhas? Use
#em cada linha. """ """/''' '''→ strings multilinha; servem como docstrings para documentar código (e só “parecem” comentários se não forem usadas).