Ключи скрипта bash через getopts: как разобрать -v и -f файл
getopts разбирает ключи, которые вы пишете после имени скрипта: -v, -f файл, -h. Ключи можно ставить в любом порядке и склеивать, а скрипт сам подскажет, если ключ неизвестен.
Содержание 8
Что сделать прямо сейчас
- Подключитесь к серверу — инструкция.
- Откройте новый файл в редакторе nano:
nano test.sh. - Вставьте текст скрипта из примера ниже.
- Сохраните файл: Ctrl+O, затем Enter, и выйдите: Ctrl+X — подробнее о nano.
- Запустите скрипт с ключами:
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.log | verbose=1, file=site.log |
bash test.sh -vf site.log | то же: ключи склеены |
bash test.sh -fsite.log | file=site.log: значение написано слитно |
bash test.sh -f -v | file=-v: ключ -f забрал следующее слово как значение |
bash test.sh один -v | ключи не разобраны: getopts остановился на слове «один» |
bash test.sh -v -- -f | verbose=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
- Только короткие ключи из одной буквы. Длинные ключи вида
--filegetopts не разбирает. - Знаки
:и?не могут быть ключами. - 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 года.
Что почитать дальше
- Аргументы скрипта$1, $@ и shift.
- Конструкция caseвыбор действия по букве ключа.
- Цикл whileкак работает цикл while.
- Функции в bashключи для функции.