Bash прощает почти всё: опечатку в имени переменной, пробел в пути, отсутствующий файл. Скрипт «работает» до первого неожиданного имени или пустого значения, а потом удаляет не тот каталог. Несколько привычек убирают большинство таких сюрпризов.
Строгий режим
#!/usr/bin/env bash
set -euo pipefail
IFS=$'\n\t'
-e— остановиться при ошибке;-u— упасть при обращении к неопределённой переменной;-o pipefail— учитывать ошибку в любой части конвейера, а не только в последней;IFS— не разбивать строки по пробелам неожиданно.
У -e есть исключения: команды в условиях if и после || не приводят к выходу. Это нормально, но требует понимания.
Кавычки
Всегда заключайте переменные в двойные кавычки: "$dir", "$@". Без них пробел в пути разобьёт аргумент на два. "$@" передаёт аргументы по отдельности, "$*" склеивает их в одну строку — это почти никогда не нужно.
Для массивов используйте "${arr[@]}". И не парсите вывод ls: имена с переводами строк сломают разбор. Берите glob или find -print0.
trap и временные файлы
tmpdir=$(mktemp -d)
cleanup() {
rm -rf -- "$tmpdir"
}
trap cleanup EXIT INT TERM
trap ... EXIT выполнится и при успехе, и при ошибке. Это надёжнее, чем удалять файл в конце: при падении до этой строки мусор останется.
Для файлов рядом с рабочим каталогом используйте mktemp с шаблоном, а не фиксированное имя: два параллельных запуска не должны затирать данные друг друга.
Проверка аргументов
if [[ $# -lt 2 ]]; then
echo "usage: $0 <source> <dest>" >&2
exit 64
fi
src=$1
dest=$2
[[ -d "$src" ]] || { echo "нет каталога: $src" >&2; exit 66; }
Проверяйте существование файлов и каталогов до работы. Коды возврата вроде 64 и 66 из sysexits.h помогают отличить ошибку использования от отсутствующего файла.
Для разбора флагов подойдёт getopts:
while getopts ":o:v" opt; do
case $opt in
o) out=$OPTARG ;;
v) verbose=1 ;;
*) echo "неизвестный флаг: -$OPTARG" >&2; exit 64 ;;
esac
done
Циклы и xargs
find . -type f -name '*.log' -print0 \
| xargs -0 -n1 -P4 gzip
-print0 и -0 безопасно передают имена с пробелами. -P4 задаёт параллельность; для тяжёлых задач она ускоряет, для сетевых запросов может создать лишнюю нагрузку.
Не используйте for f in $(find ...): подстановка разобьёт имена и потеряет кавычки.
Логирование
log() {
printf '%s %s\n' "$(date '+%F %T')" "$*" >> "$logfile"
}
Пишите дату, уровень и понятное сообщение. Для интерактивных скриптов дублируйте в stderr, для cron — в файл. Не логируйте пароли и токены, даже в отладочном режиме.
Проверка
Запустите shellcheck script.sh — он ловит неэкранированные переменные, неверные условия и типичные ошибки. Проверьте скрипт на пути с пробелом и кириллицей, на пустом каталоге и на отсутствующем файле. Эти три случая покрывают большинство падений.
Для задач по расписанию см. генератор cron, а для сравнения версий скрипта — сравнение кода.
Если скрипт может запускаться одновременно (cron и вручную), поставьте файловую блокировку: flock -n /tmp/task.lock ./task.sh. Без неё два процесса начнут писать в один файл и перемешают данные.
Возвращайте осмысленный код выхода: 0 — успех, 1 — общая ошибка, 2 — неверные аргументы. Мониторинг и cron по коду поймут, стоит ли слать уведомление.
Проверяйте скрипт в том окружении, где он будет работать: в cron другой PATH, нет интерактивного ввода и другие права. Абсолютные пути к php и утилитам снимают половину проблем.
Держите скрипт в репозитории и проверяйте его в CI так же, как код. Пара строк shellcheck и запуск на тестовом каталоге ловят ошибки до продакшена. И не делайте скрипт «умнее», чем нужно: чем меньше логики в bash, тем меньше способов сломаться.
Проверьте скрипт на пустом наборе файлов: отсутствие данных — самый частый сценарий в cron, и он не должен выглядеть как авария.
Коротко
set -euo pipefail— базовая защита;- кавычки вокруг переменных и
"$@"обязательны; trap ... EXITубирает временные файлы;- аргументы проверяйте до начала работы;
find -print0 | xargs -0вместо разбораls.