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

Ctrl + "/"

В Python несколько строк можно закомментировать, используя тройные кавычки (''' или """). Однако это скорее способ сделать многострочный строковый литерал, который не будет использован в коде, чем настоящий многострочный комментарий.

Пример использования тройных кавычек:

'''
Этот текст
будет проигнорирован
интерпретатором Python
'''

Для комментариев лучше использовать одиночные комментарии (#) на каждой строке:

# Это строка комментария
# Это еще одна строка комментария

Если следовать стилю кодирования, то PEP-8 рекомендует использовать # и для блочных комментариев. Это значит, что комментировать нужно каждую строку. Например:

# Первая строка комментария
# Вторая строка комментария
# и т.д.

Но существует хак, а именно заключать строковые литералы в тройные апострофы:

'''
Первая строка комментария
Вторая строка комментария
и т.д.
'''

Этот вариант, кстати, предложил сам создатель языка Python Гвидо ван Россум – https://twitter.com/gvanrossum/status/112670605505077248

Выделите строки и нажмите Ctrl + / (на macOS Cmd + /). Редактор поставит # в начало каждой строки. Повторное нажатие снимет комментарии.

Сочетание работает в VS Code, PyCharm, Jupyter Notebook, Sublime Text и Thonny.

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

Отдельного синтаксиса для многострочных комментариев в Python нет. Каждую строку комментируют решёткой:

# Считаем стоимость заказа
# с учётом скидки и доставки
total = price * (1 - discount) + delivery

Так рекомендует руководство по стилю PEP 8.

Тройные кавычки

Иногда код закрывают тройными кавычками:

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

Код внутри не выполнится, но это строка, которую Python создаёт и сразу выбрасывает. Если поставить её первой строкой функции, класса или модуля, она станет docstring — документацией, которую показывает help(). Для документации тройные кавычки и используют:

def area(r):
    """Возвращает площадь круга радиуса r."""
    return 3.14159 * r ** 2

Внутри тройных кавычек нельзя закомментировать код, в котором уже есть такие же тройные кавычки.

Закомментировать весь файл

Выделите всё (Ctrl + A) и нажмите Ctrl + /.

Сочетания клавиш в редакторах

Если Ctrl + / не работает, проверьте раскладку: в некоторых редакторах сочетание срабатывает только на английской.

Ненужный код удаляют

Закомментированный код, который больше не нужен, удаляют. Старая версия останется в истории Git, и её можно вернуть.

Синтаксис Python и стиль кода по PEP 8 разбирают в бесплатном курсе «Основы Python».