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

Отладка скрипта bash: как увидеть, что выполняется, и найти ошибку

Когда скрипт делает не то, что задумано, bash может показать каждую команду перед выполнением — уже с подставленными значениями. Так видно, на каком шаге что-то пошло не так.

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

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

  1. Подключитесь к серверу — инструкция.
  2. Откройте новый файл в редакторе nano: nano test.sh.
  3. Вставьте текст скрипта из примера ниже.
  4. Сохраните файл: Ctrl+O, затем Enter, и выйдите: Ctrl+X — подробнее о nano.
  5. Запустите скрипт с трассировкой: bash -x test.sh.
#!/bin/bash
a=5
b=$(echo 3)
echo $(( a + b ))

Ответ:

+ a=5
++ echo 3
+ b=3
+ echo 8
8

Строки с + — это команды, которые выполнил bash, со значениями после подстановки. Два плюса — команда внутри $( ). Последняя строка 8 — сам вывод скрипта.

Проверить текст без запуска: bash -n

bash -n test.sh

bash прочитает скрипт, но не выполнит ни одной команды. Если ответа нет — ошибок записи нет: все if закрыты словом fi, циклы — словом done, кавычки — парные. Если ошибка есть, bash назовёт номер строки, а код возврата будет ненулевым.

bash -n не найдёт опечатку в имени команды или переменной: это видно только при запуске.

Опечатка в имени переменной

#!/bin/bash
dir=/var/empty
ls $dri

Скрипт покажет содержимое текущей папки, а не /var/empty. Трассировка bash -x test.sh объясняет почему:

+ dir=/var/empty
+ ls

После ls ничего нет: переменной dri не существует, и bash подставил пустоту. Чтобы такая опечатка останавливала скрипт, добавьте второй строкой set -u. Тогда bash сообщит, что переменная dri не задана, и завершит скрипт с ненулевым кодом. Про строгий режим — в статье Код возврата.

Трассировка части скрипта: set -x

Чтобы не смотреть весь скрипт, включите трассировку перед нужным местом и выключите после. PS4 — это начало строки трассировки, в него удобно добавить номер строки:

#!/bin/bash
PS4='+ строка $LINENO: '
set -x
a=5
echo "$a"
set +x
echo "без трассировки"

Ответ:

+ строка 4: a=5
+ строка 5: echo 5
5
+ строка 6: set +x
без трассировки

PS4 пишут в одинарных кавычках, чтобы $LINENO подставлялся на каждой строке заново. Задавайте PS4 внутри скрипта, до set -x.

Записать трассировку в файл

Трассировка идёт в поток ошибок, а вывод скрипта — в стандартный вывод. Поэтому их можно разделить:

bash -x test.sh 2> trace.log
nano trace.log

На экране останется только вывод скрипта, а все строки с + окажутся в trace.log. Свои отладочные сообщения тоже отправляйте в поток ошибок, чтобы они не смешивались с результатом: echo "Шаг 2: копирую" >&2. Подробнее — Перенаправление вывода.

Скрипт из Windows: лишний знак в конце строк

Если скрипт написан в Windows и скопирован на сервер, в конце каждой строки может остаться невидимый знак возврата каретки. bash видит его как часть команды, и ошибки сыплются на строках, которые выглядят правильно. Проверьте:

cat -A test.sh

Если строки заканчиваются на ^M$, а не на $, уберите лишние знаки:

sed -i 's/\r$//' test.sh

Почему так бывает с файлами из Git — в статье LF will be replaced by CRLF.

Проверка программой shellcheck

shellcheck читает скрипт, ничего не выполняя, и указывает места, где вероятна ошибка, — например, переменные без кавычек. Программа есть в репозитории Ubuntu 24.04:

sudo apt install shellcheck
shellcheck test.sh

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

Что видноЧто значитЧто сделать
bash -n молчит, а скрипт падаетошибка в командах, а не в записизапустите bash -x test.sh
в трассировке пусто после командыпеременная пустая или с опечаткойсверьте имя, добавьте set -u
трассировка перемешалась с выводомоба потока идут на экранзапишите трассировку в файл: 2> trace.log
номер строки не меняетсяPS4 в двойных кавычкахпишите PS4 в одинарных кавычках
ошибки на каждой строке, текст верныйконцы строк из Windowsуберите их: sed -i 's/\r$//' test.sh

Источники

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

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

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