Python

Как закомментировать несколько строк в Python: #, горячие клавиши и тройные кавычки

В Python настоящий комментарий начинается с символа #. Если нужно закомментировать несколько строк, обычно ставят # в начале каждой строки или используют горячую клавишу редактора, которая делает это автоматически

# print("Эта строка не выполнится")
# print("И эта тоже не выполнится")
# print("Python пропустит эти строки")

Это самый надежный и понятный способ. Он работает одинаково в обычных скриптах, учебных задачах, проектах и редакторах кода

Как быстро закомментировать блок в редакторе

В VS Code, PyCharm и многих других редакторах можно выделить несколько строк и нажать горячую клавишу. На Windows и Linux чаще всего это Ctrl + /, на macOS — Cmd + /. Редактор сам добавит # в начало каждой выделенной строки, а при повторном нажатии уберет комментарии обратно

Пример до

name = input("Имя: ")
print("Привет")
print(name)

После выделения и горячей клавиши

# name = input("Имя: ")
# print("Привет")
# print(name)

Так удобно временно отключать кусок кода, пока вы проверяете другую часть программы

Есть ли в Python многострочный комментарий

В Python нет отдельного синтаксиса многострочного комментария как в некоторых языках. Например, в JavaScript есть / ... /, а в Python для обычных комментариев используют # на каждой строке

Иногда в интернете показывают такой вариант

"""
Этот блок выглядит как многострочный комментарий
Но технически это строка
"""

Такой код действительно часто не мешает программе, если строка стоит сама по себе. Но это не комментарий в строгом смысле: это строковый литерал. В некоторых местах он может стать docstring, попасть в __doc__ или просто создать лишнее значение, которое Python прочитает

Когда тройные кавычки уместны

Тройные кавычки нужны для многострочных строк и документации функций, классов и модулей

def add(a, b):
    """Возвращает сумму двух чисел"""
    return a + b

Здесь строка под функцией — это docstring, то есть документация функции. Это нормальное применение тройных кавычек, но это не то же самое, что временно закомментировать кусок кода

Если вы хотите именно отключить код, используйте #

Как закомментировать часть строки

Комментарий можно поставить после кода

price = 1000  # цена без скидки

Такой комментарий стоит использовать только тогда, когда он реально помогает. Не нужно писать очевидное

Плохо

price = 1000  # присваиваем 1000 переменной price

Лучше

price = 1000  # базовая цена до сезонной скидки

Как временно отключить кусок кода

Допустим, у вас есть программа

name = input("Имя: ")
age = int(input("Возраст: "))

print(f"Привет, {name}")
print(f"Через год вам будет {age + 1}")

Если вы хотите временно убрать ввод возраста, можно закомментировать связанные строки

name = input("Имя: ")
# age = int(input("Возраст: "))

print(f"Привет, {name}")
# print(f"Через год вам будет {age + 1}")

Важно комментировать не случайные строки, а весь связанный кусок. Если закомментировать только строку с age, но оставить print(age + 1), программа упадет с NameError, потому что переменная не была создана

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

Комментарий внутри блока обычно ставят с тем же отступом, что и код вокруг него

if user_age >= 18:
    # показываем раздел только взрослым пользователям
    print("Доступ разрешен")

Если комментарий стоит внутри функции, цикла или условия, сохраняйте отступ. Это делает код читаемым и помогает не потерять структуру программы

Мини-задача

Возьмите код и временно отключите часть про скидку

price = 1000
discount = 15
final_price = price - price * discount / 100

print(final_price)

Должно получиться так

price = 1000
# discount = 15
# final_price = price - price * discount / 100

print(price)

Теперь программа выводит исходную цену, а код со скидкой сохранен для будущей проверки

Частые ошибки

Использую тройные кавычки и думаю, что это комментарий

Для временного отключения кода лучше использовать #. Тройные кавычки — это строка, и в некоторых местах она имеет смысл для Python

Закомментировал переменную, но оставил ее использование

Если код ниже обращается к переменной, которую вы закомментировали, появится NameError. Комментируйте весь связанный блок или перепишите оставшийся код

Горячая клавиша не работает

Проверьте раскладку, фокус редактора и настройки горячих клавиш. Но ручной способ всегда остается тем же: # в начале строки

Что почитать дальше по Python

Если нужен общий маршрут по теме, откройте рубрику Python. Для соседних задач пригодятся эти разборы:

0 комментариев

Старые

Новые Популярные