Комментарии и простые опечатки

В прошлом уроке мы создали файл hello.py и запустили его командой python hello.py. Теперь добавим в этот файл кое-что новое — комментарии. А заодно намеренно сломаем код, чтобы впервые увидеть, как Python сообщает об ошибках.

Однострочный комментарий: синтаксис и назначение

Символ # превращает остаток строки в комментарий. Всё, что стоит после него до конца строки, Python читать не будет — интерпретатор просто пропускает этот текст, как будто его нет.

Комментарий может занимать целую строку:

# Это приветствие для пользователя
print("Привет, мир!")

А может идти прямо после инструкции — такой вариант называют встроенным комментарием:

print("Привет, мир!")  # выводим текст в терминал

Оба варианта равнозначны с точки зрения Python. Разница только в том, где удобнее читать пояснение.

Комментарии нужны не программе, а человеку. Через неделю вы откроете свой файл и не вспомните, зачем написали ту или иную строку — комментарий решает эту проблему. Кроме того, когда кто-то другой читает ваш код, комментарии снижают время на понимание.

Важный момент: # внутри строковых кавычек — это не комментарий, а обычный символ:

print("цена: #100")  # здесь # внутри кавычек — просто символ решётки

В этом примере #100 попадёт в вывод как текст, а второй # после закрывающей кавычки — настоящий комментарий.