Код возврата в bash: $?, exit и проверка ошибок в скрипте
Каждая команда, закончив работу, сообщает bash число — код возврата. Ноль значит «всё получилось», любое другое число — «что-то пошло не так». На этих числах держатся if, && и || и любая проверка ошибок в скрипте.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу — инструкция.
- Найдите строку root в файле /etc/passwd:
grep -q root /etc/passwd. - Сразу после этого посмотрите код:
echo $?. Ответ —0: строка нашлась. - Теперь поищите то, чего в файле нет:
grep -q nosuchuser /etc/passwd, затем сноваecho $?. Ответ —1: ничего не найдено.
Как посмотреть код: $?
$? хранит код последней выполненной команды. Смотреть его нужно сразу: следующая команда, даже echo, запишет туда свой код. Если код нужен позже, сохраните его в переменную:
grep -q root /etc/passwd
code=$?
echo "Код grep: $code"Что значат коды
| Код | Что значит |
|---|---|
0 | команда выполнилась успешно |
1 | ошибка; что именно — зависит от команды: у grep это «ничего не найдено» |
2 | встроенная команда bash вызвана неверно; у grep — ошибка, например нет файла |
126 | команда найдена, но не запускается — у файла нет права на запуск |
127 | команда не найдена — опечатка в имени или программа не установлена |
128 + N | команду остановил сигнал с номером N |
130 | вы нажали Ctrl+C: это 128 + 2, где 2 — номер сигнала SIGINT |
Коды 126, 127 и 128 + N выставляет сам bash. Остальные ненулевые коды каждая программа выбирает сама — их список ищите в справке программы, в разделе EXIT STATUS. Про код 126 подробно — в статье Permission denied при запуске скрипта.
Проверить код в скрипте
Смотреть $? руками не обязательно: if, && и || сами проверяют код команды.
#!/bin/bash
if grep -q "root" /etc/passwd; then
echo "Строка найдена"
else
echo "Строки нет"
fiкоманда1 && команда2— вторая выполнится, только если первая вернула0. Пример:cd /var/www && ls.команда1 || команда2— вторая выполнится, только если первая вернула не ноль. Пример:cd /var/www/site || exit 1.
Строка cd папка || exit 1 защищает от беды: если папки нет, скрипт остановится и не станет выполнять следующие команды не в той папке. Как писать условия — в статье Условие if.
Завершить скрипт с кодом: exit
exit завершает скрипт и передаёт код тому, кто его запустил: вам в терминале, cron или другому скрипту. Без числа exit вернёт код последней команды. Если exit в скрипте нет, код скрипта — это код последней выполненной в нём команды.
#!/bin/bash
if ! tar -czf "$HOME/site.tar.gz" -C /var/www site; then
echo "Копия не создана"
exit 1
fi
echo "Копия готова"Запустите скрипт — bash test.sh — и сразу посмотрите его код: echo $?. ! перед командой меняет её код на противоположный: ветка then сработает, если tar завершился с ошибкой.
Внутри функции вместо exit пишут return — он завершает только функцию. Подробнее — Функции в bash.
Остановить скрипт при первой ошибке: set -e
#!/bin/bash
set -e
echo "Начало"
false
echo "Сюда скрипт не дойдёт"Скрипт выведет только «Начало» и завершится с кодом 1 — это код команды false.
set -e не срабатывает на командах, код которых проверяют:
- в условии if, elif, while и until;
- в цепочке из
&&и||— кроме последней команды цепочки; - в конвейере — кроме последней команды;
- после
!.
Поэтому строка grep -q текст файл || echo "не нашёл" скрипт не остановит, даже если grep ничего не найдёт.
Осторожно со счётчиком ((n++)): когда n равно нулю, такая строка возвращает код 1, и set -e остановит скрипт. Пишите n=$((n + 1)) — подробнее в статье Арифметика в bash.
Код конвейера: pipefail и PIPESTATUS
Код конвейера команда1 | команда2 — это код последней команды. Ошибка в первой при этом не видна: у false | true код 0.
Строка set -o pipefail в начале скрипта меняет правило: код конвейера — код самой правой команды, которая завершилась с ошибкой, а ноль — только если все команды выполнились успешно.
Код каждой команды конвейера по отдельности хранит массив PIPESTATUS. Смотреть его нужно сразу после конвейера:
false | true
echo "${PIPESTATUS[@]}"Ответ:
1 0Ошибки и как их исправить
| Что видно | Что значит | Что сделать |
|---|---|---|
echo $? показывает 0, хотя команда не сработала | между командой и echo $? была другая команда | смотрите $? сразу или сохраните его: code=$? |
код 127 | команда не найдена | проверьте имя и что программа установлена |
код 126 | у файла нет права на запуск | chmod +x файл — подробнее о chmod |
скрипт с set -e остановился на ((n++)) | выражение было равно нулю | пишите n=$((n + 1)) |
| ошибка в начале конвейера не замечена | код конвейера — код последней команды | добавьте set -o pipefail |
| скрипт не остановился после ошибки | ошибку не проверили | проверьте код через if или добавьте в начало set -e |
Источники
- Справка bash для Ubuntu 24.04 — код возврата команд, коды 126, 127 и 128+N, exit, set -e и его исключения, pipefail, PIPESTATUS, оператор ! перед командой.
- Справка grep для Ubuntu 24.04 — ключ -q и коды выхода 0, 1 и 2.
- Справка signal для Ubuntu 24.04 — номера сигналов, у SIGINT — 2.
Сверено 20 октября 2026 года.
Что почитать дальше
- Условие ifусловия, которые работают по коду.
- Функции в bashreturn и код функции.
- Permission denied при запуске скриптаоткуда берётся код 126.
- Цикл whileциклы, которые повторяют, пока код равен нулю.
- Команда trapубрать за собой при выходе, ошибке и Ctrl+C.
- Отладка скриптанайти строку, на которой скрипт ломается.