Поиск
Справочник

Ключи скрипта bash через getopts: как разобрать -v и -f файл

getopts разбирает ключи, которые вы пишете после имени скрипта: -v, -f файл, -h. Ключи можно ставить в любом порядке и склеивать, а скрипт сам подскажет, если ключ неизвестен.

≈ 4 мин чтения
Содержание 8

Что сделать прямо сейчас

  1. Подключитесь к серверу — инструкция.
  2. Откройте новый файл в редакторе nano: nano test.sh.
  3. Вставьте текст скрипта из примера ниже.
  4. Сохраните файл: Ctrl+O, затем Enter, и выйдите: Ctrl+X — подробнее о nano.
  5. Запустите скрипт с ключами: bash test.sh -v -f site.log один два.
#!/bin/bash
verbose=0
file=""
while getopts "vf:h" opt; do
    case "$opt" in
        v) verbose=1 ;;
        f) file="$OPTARG" ;;
        h) echo "Использование: $0 [-v] [-f файл] [имя...]"; exit 0 ;;
        *) echo "Неизвестный ключ. Справка: $0 -h"; exit 1 ;;
    esac
done
shift $((OPTIND - 1))
echo "verbose=$verbose file=$file"
echo "Остальное: $*"

Ответ:

verbose=1 file=site.log
Остальное: один два

Запустите bash test.sh -h — скрипт покажет строку «Использование: test.sh [-v] [-f файл] [имя...]».

Как устроен разбор

  • "vf:h" — строка ключей: буквы, которые понимает скрипт.
  • Двоеточие после буквы значит, что ключу нужно значение: f: ждёт -f site.log.
  • Каждый проход цикла while кладёт в переменную opt букву очередного ключа, а case выбирает, что с ней делать — подробнее в статье Конструкция case.
  • Значение ключа лежит в переменной OPTARG.
  • Когда ключи кончились, getopts возвращает ненулевой код, и цикл заканчивается.

В OPTIND getopts хранит номер следующего слова для разбора. Строка shift $((OPTIND - 1)) убирает разобранные ключи, и после неё $1 — первое слово без минуса. Без этой строки в $1 останется -v. Как работают $1 и shift — в статье Аргументы скрипта.

Как можно писать ключи

ЗапускЧто получит скрипт
bash test.sh -v -f site.logverbose=1, file=site.log
bash test.sh -vf site.logто же: ключи склеены
bash test.sh -fsite.logfile=site.log: значение написано слитно
bash test.sh -f -vfile=-v: ключ -f забрал следующее слово как значение
bash test.sh один -vключи не разобраны: getopts остановился на слове «один»
bash test.sh -v -- -fverbose=1, а -f осталось в $1

getopts читает ключи только до первого слова без минуса, поэтому ставьте ключи перед остальными словами. Два минуса -- означают «ключи кончились»: так передают имя файла, которое начинается с минуса.

Свои сообщения об ошибках

Если строка ключей начинается с двоеточия, bash не печатает своё сообщение об ошибке и оставляет разбор скрипту:

#!/bin/bash
while getopts ":f:" opt; do
    case "$opt" in
        f) echo "файл $OPTARG" ;;
        :) echo "Ключу -$OPTARG нужно значение"; exit 1 ;;
        \?) echo "Нет ключа -$OPTARG"; exit 1 ;;
    esac
done
ЗапускОтвет
bash test.sh -fКлючу -f нужно значение
bash test.sh -zНет ключа -z
bash test.sh -fa.txtфайл a.txt

В этом режиме : в opt означает «нет значения», ? — «неизвестный ключ», а в OPTARG лежит буква ключа. Знак ? в case пишут как \?, иначе он совпадёт с любой одной буквой.

Без двоеточия в начале, как в первом примере, bash сам выведет своё сообщение об ошибке, а скрипт попадёт в ветку *).

Ограничения getopts

  • Только короткие ключи из одной буквы. Длинные ключи вида --file getopts не разбирает.
  • Знаки : и ? не могут быть ключами.
  • OPTIND не сбрасывается сам. Если разбираете ключи второй раз — например, в функции, — сначала напишите OPTIND=1.

Ошибки и как их исправить

Что видноЧто значитЧто сделать
$1 после цикла — это -vнет строки shiftдопишите shift $((OPTIND - 1)) после done
ключи после имени файла не сработалиgetopts остановился на первом слове без минусапишите ключи перед словами
значение ключа пустоев строке ключей нет двоеточия после буквыпишите f: вместо f
ключ -f забрал следующий ключпосле -f не написали значениепроверяйте OPTARG или пишите значение сразу после ключа
кроме вашего выводится сообщение bashстрока ключей без двоеточия в началеначните её с : и разберите : и \? сами
второй разбор ничего не находитOPTIND остался от прошлого разборанапишите OPTIND=1 перед циклом

Источники

  • Справка bash для Ubuntu 24.04 — встроенная команда getopts: строка ключей, двоеточие после буквы, OPTARG и OPTIND, тихий режим с : в начале, OPTIND не сбрасывается сам, : и ? не бывают ключами.

Сверено 20 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

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