Степенность есть надежная пружина в механизме общежития (К. Прутков).

Написание комментариев в скриптах Bash

2 мин для чтения
FavoriteLoadingДобавить в избранное
1 Звезда2 Звезды3 Звезды4 Звезды5 Звезд (1 оценок, среднее: 5,00 из 5)
Загрузка...
3 октября 2019
Shebang в Оболочки Linux Bash
При написании сценариев Bash всегда полезно делать код понятным и понятным. Организация вашего кода по блокам, отступы, присвоение переменным и функциям описательных имен – это несколько способов сделать это.

Еще один способ улучшить читабельность вашего кода – использование комментариев. Комментарий – это понятное человеку объяснение или аннотация, написанная в сценарии оболочки.

Добавление комментариев к вашим сценариям Bash сэкономит вам много времени и усилий, если вы посмотрите на свой код в будущем. Допустим, вы хотите изменить сценарий, который вы написали несколько месяцев или лет назад. Скорее всего, вы не вспомните, почему написали какой-то сложный фрагмент кода, если не добавили комментарий.

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

Комментарии обычно используются для объяснения того, что код не может. Например, если у вас есть сложное регулярное выражение или подстановка параметров внутри вашего Bash-скрипта, вы должны написать комментарий о том, что делает код. Комментарии должны быть краткими и точными. Не объясняйте что-то простое и очевидное для читателя.

В этой статье мы рассмотрим основы написания комментариев на Bash.

 

Bash игнорирует все, что написано после хеш-метки ( #) в строке. Единственное исключение из этого правила – первая строка в скрипте начинается с #!символов. Эта последовательность символов называется Shebang и используется, чтобы сообщить операционной системе, какой интерпретатор использовать для анализа остальной части файла.

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

# Tэто комментарий Bash.
echo "Это код" # Это встроенный комментарий Bash.

 

Пробел после хеш-метки не обязателен, но он улучшит читабельность комментария.

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

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

# if [[ $VAR -gt 10 ]]; then
#  echo "Переменная больше 10."
# fi

 

В отличие от большинства языков программирования, Bash не поддерживает многострочные комментарии.

Самый простой способ написать многострочные комментарии в Bash – добавить отдельные комментарии один за другим:

# Это первая строка.
# Это вторая строка.

 

Другим вариантом является использование HereDoc. Это тип перенаправления, который позволяет передавать несколько строк ввода в команду. Если блок HereDoc не перенаправлен в команду, он может служить заполнителем многострочных комментариев:

<< 'MULTILINE-COMMENT'
    Все внутри тела 
    HereDoc является 
    многострочным комментарием
MULTILINE-COMMENT

 

Использование HereDoc – это хак, а не настоящий встроенный способ написания многострочных комментариев Bash. Чтобы избежать каких-либо проблем, вы должны использовать однострочные комментарии.

 

Написание комментариев является хорошей практикой и помогает другим разработчикам, в том числе будущему самому, понять сценарий оболочки. В Bash все после хеш-метки ( #) и до конца строки считается комментарием.

Если у вас есть какие-либо вопросы или отзывы, не стесняйтесь оставлять комментарии.

Если вы нашли ошибку, пожалуйста, выделите фрагмент текста и нажмите Ctrl+Enter.

Просмотров: 404

Если статья понравилась, то поделитесь ей в социальных сетях:

Добавить комментарий

Войти с помощью: 

Ваш e-mail не будет опубликован. Обязательные поля помечены *

Сообщить об опечатке

Текст, который будет отправлен нашим редакторам:

Заполните форму и наш менеджер перезвонит Вам в самое ближайшее время!

badge
Обратный звонок 1
Отправить
galka

Спасибо! Ваша заявка принята

close
galka

Спасибо! Ваша заявка принята

close