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

Код возврата в bash: $?, exit и проверка ошибок в скрипте

Каждая команда, закончив работу, сообщает bash число — код возврата. Ноль значит «всё получилось», любое другое число — «что-то пошло не так». На этих числах держатся if, && и || и любая проверка ошибок в скрипте.

≈ 5 мин чтения
Содержание 10

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

  1. Подключитесь к серверу — инструкция.
  2. Найдите строку root в файле /etc/passwd: grep -q root /etc/passwd.
  3. Сразу после этого посмотрите код: echo $?. Ответ — 0: строка нашлась.
  4. Теперь поищите то, чего в файле нет: 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

Источники

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

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

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