Отладка скрипта bash: как увидеть, что выполняется, и найти ошибку
Когда скрипт делает не то, что задумано, bash может показать каждую команду перед выполнением — уже с подставленными значениями. Так видно, на каком шаге что-то пошло не так.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу — инструкция.
- Откройте новый файл в редакторе nano:
nano test.sh. - Вставьте текст скрипта из примера ниже.
- Сохраните файл: Ctrl+O, затем Enter, и выйдите: Ctrl+X — подробнее о nano.
- Запустите скрипт с трассировкой:
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.shbash прочитает скрипт, но не выполнит ни одной команды. Если ответа нет — ошибок записи нет: все 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 |
Источники
- Справка bash для Ubuntu 24.04 — ключи -n, -v и -x, переменные PS4 и LINENO, set -u; трассировка выводится в поток ошибок.
- Справка cat для Ubuntu 24.04 — ключ -A показывает невидимые знаки и конец строки.
- Справка sed для Ubuntu 24.04 — ключ -i правит файл на месте.
- Пакет shellcheck для Ubuntu 24.04 — программа проверки скриптов, раздел universe.
Сверено 20 октября 2026 года.
Что почитать дальше
- Код возвратаset -e, set -u и pipefail.
- Команда trapвывести номер строки при ошибке.
- Кавычки в bashпустые переменные и кавычки.
- Permission denied при запуске скриптаскрипт не запускается.