Комментарии

Программы читают не только компьютеры, но и люди: ваши коллеги и вы сами через несколько недель, когда уже не помните, почему написали что-то именно так. Поэтому в языках программирования есть комментарии: заметки в коде, которые компьютер игнорирует.

В Python комментарий начинается с символа решётка #. Всё, что идёт после него до конца строки, игнорируется. Комментарий может стоять на отдельной строке или в конце строки с кодом:

# Выводит цену двух билетов
print(2 * 150)  # 150 — цена одного билета

Программа выведет только:

300

Для более длинной заметки используйте несколько строк и начинайте каждую с #:

# Автор: Иван Петров
# Дата: 8 марта 2024
print(2 * 150)

Хороший комментарий говорит о том, чего с первого взгляда не видно в коде: для чего нужна часть программы или почему значение именно такое.

Комментарии также полезны, чтобы ненадолго отключить код, не удаляя его. Программисты называют это закомментировать: поставьте # в начало строки, и она перестанет выполняться. Когда захотите вернуть её, просто удалите #.

print("Эта строка выполняется.")
# print("Эта — нет.")

Программа выведет:

Эта строка выполняется.