Как закомментить код питон

Комментирование кода в Python (Урок №5)

Прежде чем двигаться далее, изучим короткую, но важную тему комментирования кода в Python.

Бывает так, что программист написал программу, отложил ее в сторону на несколько дней, а потом с удивлением понимает, что уже и не помнит, что там нагородил =)

На самом деле, это частая ситуация. Я сам регулярно возвращаюсь к своим старым программам и радуюсь (но не всегда), что комментировал собственный код.

И, как результат, я быстрее понимаю, что сам и написал =)

Что такое комментирование кода?

Если кратко, то это поясняющие записи, к тем или иным командам. Можно провести аналогию с заметками на полях книги.

Но прежде чем продолжить далее, отмечу, что можете посмотреть видео (в нем больше информации, по понятным причинам), или прочитать текстовую версию чуть ниже.

Не забудьте подписаться на мой Видеоканал в Яндекс.Дзен.

Как комментировать код в Python?

b=3 #задаем переменную b c=5 #задаем переменную c d=b+c print(d) #выводим результат

При этом, интерпретатор Python игнорирует все символы, которые находятся после # и до конца строки.

Обратите внимание, что можно не только оставлять полезные заметки, поясняющие работу программу, но и временно «блокировать» выполнение той или иной команды.

b=3 #задаем переменную b c=5 #задаем переменную c d=b + c # print(c) # print(b) print(d) #выводим результат

Если мы запустим код выше на выполнение, то получим 8 (результат сложения переменных d = b + c).

закомментированы, то они не будут исполняться интерпретатором. И мы не увидим на экране, какие значения у переменных b и c.

Это полезная фича, когда тестируется программа, или ищут ошибки в коде.

Но в финальном варианте программы, разумеется, закомментированные команды лучше удалить, чтобы не засорять код командами, которые не используются при работе программы.

При этом поясняющие комментарии лучше оставить.

Понятно, что не нужно комментировать абсолютно все команды. Но важные моменты, или те, что нельзя сразу понять, лучше пояснить.

Сами потом себя похвалите за предусмотрительность, когда через какое-то время вернетесь к тому ,что написали.

Как сразу закомментировать много строк кода?

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

К счастью, большинство редакторов кода позволяют это сделать быстро.

Например, если используете PyCharm, то достаточно выделить нужный блок кода и нажать сочетание клавиш CTRL + /

Если нужно раскомментировать много строк кода, то опять выделяем нужные строки и снова нажимаем сочетание клавиш CTRL + /.

Уроки по Python 3:

Источник

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

В Python, для однострочных комментариев используется символ # . Но если нужно закомментировать большой блок кода, то приходится приписывать # в начале каждой строки. Это очень неудобно при отладке. Есть ли какая-то возможность использовать многострочные комментарии (аналог /* . */ из Си) в Python? UPD: Знаю, что различные IDE позволяют делать такие вещи автоматически, но хотелось бы более элегантного решения, не зависящего от средства редактирования кода и различных утилит.

Мой вопрос сводится скорее к «как использовать многострочные комментарии в языке, где нет многострочных комментариев», а не к «как использовать редакторы кода для автоматического создания пачки однострочных комментариев»

5 ответов 5

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

''' Это строковый литерал. Но здесь он используется как многострочный комментарий ''' 

Строковые литералы, заключенные в тройные кавычки, могут содержать:

• кавычки ( » )
• апострофы ( ‘ )
• docstring комментарии ( «»»func desc»»» )
• переводы строк

В тоже время, стоит помнить, что такой строковый литерал не должен содержать внутри символов »’ . Это требование аналогично запрету на последовательность символов */ внутри многострочного комментария Си.

Кстати, этот же хак, предлагает использовать создатель языка Python в одном из своих твитов.

В тоже время, как верно отметил @jfs, руководство по стилю кода (pep-8) рекомендует использовать # для блочных комментариев.

Руководство по стилю кода (pep-8) рекомендует использовать # для блочных комментариев.

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

Один из явных признаков неумелого программирования — это наличие закомментированных фрагментов кода. Используйте систему контроля версий и/или ваше IDE, чтобы временно убрать/закомментировать код при отладке. Настройте ваше окружение, чтобы вы могли это делать не задумываясь, нажимая пару клавиш.

Знаю, что различные IDE позволяют делать такие вещи автоматически, но хотелось бы более элегантного решения, не зависящего от средства редактирования кода и различных утилит.

Закомментированный код не должен добавляться в систему контроля версий, поэтому для временных изменений, которые не переживут одну сессию редактирования кода, один клавишный аккорд (например, M-; в Emacs), как правило, достаточен, чтобы закомментировать/раскомментировать кусок кода.

«»»multiline string literal»»» не является многострочным комментарием в Питоне. Это просто строковая константа, которая позволяет использовать буквальные символы новой строки без экранирования (такого как \n ). Часто используется для описаний модулей, классов, функций/методов прямо в коде:

>>> def f(): . """abc""" . >>> f.__doc__ 'abc' 

Попытка использовать «»»»»» в качестве многострочного комментария сломается на первой docstring, даже если бы не было других более подходящий решений для данной задачи.

Источник

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

Зачастую при разработке программ на Python возникает необходимость временно отключить выполнение определенного блока кода. Это может быть необходимо при отладке, тестировании или просто при написании экспериментального кода, который в конечном итоге может быть не нужен.

Рассмотрим типичный случай. Представим, есть большой кусок кода, который в данный момент не нужен, но который может потребоваться в будущем:

a = 5 b = 10 c = a + b print(c)

Итак, в Python есть два основных способа закомментировать код:

Использование символа решетки (#)

Символ решетки (#) используется для комментирования отдельных строк кода. Все, что следует после символа # в строке кода, Python игнорирует:

#a = 5 #b = 10 #c = a + b #print(c)

Однако, если нужно закомментировать большой блок кода, вставка # перед каждой строкой может быть утомительной.

Использование тройных кавычек («»»)

Тройные кавычки используются для комментирования больших блоков кода:

''' a = 5 b = 10 c = a + b print(c) '''

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

К сожалению, в Python нет встроенных механизмов для комментирования больших блоков кода, как, например, в некоторых других языках программирования. Однако, многие среды разработки предлагают собственные инструменты для этого. Например, в PyCharm можно выделить необходимый блок кода и нажать комбинацию клавиш Ctrl + / , и все строки будут автоматически закомментированы.

Источник

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

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

Когда нужно использовать комментарии в Python

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

Итак, комментарии нужны, чтобы:

• Предотвратить выполнение кода. Иногда вам нужно сделать так, чтобы часть написанного кода не выполнялась. Возможно, она не нужна вам именно в этот момент, но вы планируете использовать ее в дальнейшем. В таком случае эту часть кода можно «закомментировать», т. е. оформить как комментарий.
• Улучшить читаемость. Это очень важно, и не только для нас самих, но и для других разработчиков. При помощи комментариев мы можем объяснить, что делает каждый блок кода. Когда другие разработчики будут читать наш код, благодаря комментариям им будет легко понять, для чего предназначена каждая его часть.

Как (за)комментировать код на Python

В разных языках программирования синтаксис комментариев тоже разный. В Python комментарии начинаются с символа #. Вот пример:

# Код, расположенный ниже, выводит в консоль фразу Hello World! print("Hello World!")

В этом коде я использовал комментарий для пояснения, что делает код. Когда этот код выполняется, интерпретатор игнорирует комментарий и запускает функцию print() .

Мы также можем закомментировать собственно сам код:

# print("Hello World!") print("Happy coding!")

При запуске этого кода будет интерпретироваться только вторая строка.

Комментарии не всегда располагаются над строкой кода, к которой они относятся. Вы можете вставлять их в саму строку:

print("Hello world") # Выводит Hello World

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

В отличие от других языков программирования, в Python нет встроенного синтаксиса для создания многострочных комментариев.

К счастью, есть два способа обойти эту проблему. Первый:

# При запуске этого кода # вы видите Hello World! # в консоли. print("Hello world")

Мы можем разделять комментарий на строки, помещая при этом символ # в начале каждой строки.

В следующем примере для размещения комментария мы используем многострочные строки (multi-line strings). Они начинаются и заканчиваются тремя кавычками (сами кавычки могут быть как двойными, так и одинарными).

""" При запуске этого кода вы видите Hello World! в консоли. """ print("Hello World!")

При использовании многострочных строк без присвоения строки в качестве значения переменной эта часть кода игнорируется.

Примечание: важно не забывать об отступах. Если сделаете неправильный отступ перед первым блоком кавычек, получите SyntaxError.

Заключение

Итак, в этой статье мы разобрали, как могут использоваться комментарии в Python, а также рассмотрели их синтаксис. Теперь у вас не должно возникнуть проблем с комментированием кода.

Источник