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

Функции в bash: как объявить, передать аргументы и вернуть результат

Функция — это кусок скрипта со своим именем. Вы один раз описываете в ней несколько команд, а потом вызываете их одним словом сколько угодно раз. Скрипт становится короче, а ошибку в нём проще найти.

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

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

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

Ответ:

Привет, Анна
Привет, Иван

Как объявить функцию

имя() {
    команды
}

Есть и второй вариант записи — со словом function: function имя { команды; }. bash понимает оба одинаково. Три правила, на которых спотыкаются новички:

  • После { нужен пробел или перевод строки: для bash фигурная скобка — отдельное слово.
  • Перед } команда должна закончиться переводом строки или точкой с запятой. В одну строку пишите так: greet() { echo "Привет"; }.
  • Объявляйте функцию выше первого вызова. bash выполняет скрипт сверху вниз и, если дойдёт до вызова раньше объявления, ответит command not found.

Аргументы функции

Аргументы передают через пробел после имени — так же, как команде. Внутри функции они доступны как $1, $2 и дальше, $# — их количество, "$@" — все сразу. Аргументы самого скрипта на это время скрываются, а после выхода из функции возвращаются.

#!/bin/bash
show() {
    echo "Аргументов: $#"
    echo "Первый: $1"
    echo "Все: $@"
}
show один два три
echo "У скрипта аргументов: $#"

Запустите его с одним аргументом — bash test.sh x:

Аргументов: 3
Первый: один
Все: один два три
У скрипта аргументов: 1

Если функции нужны аргументы скрипта, передайте их явно: show "$@". Об аргументах скрипта — в статье Аргументы скрипта.

Переменные: общие и local

Переменные в bash общие: функция видит переменные скрипта и может их изменить. Слово local создаёт переменную, которая живёт только внутри функции и в функциях, которые она вызывает.

#!/bin/bash
name="Анна"
change() {
    local name="Иван"
    city="Москва"
}
change
echo "$name $city"

Ответ:

Анна Москва

name снаружи не изменилась: внутри функции она объявлена через local. А city функция создала без local, и переменная осталась после вызова. Объявляйте через local всё, что нужно только внутри функции, — так функция не испортит переменные скрипта. Подробнее о переменных — Переменные в bash.

Код возврата: return

return завершает функцию и передаёт код — число от 0 до 255. Ноль значит «всё хорошо», любое другое число — ошибку. Без числа или без return функция вернёт код своей последней команды.

#!/bin/bash
is_big() {
    if [ "$1" -gt 100 ]; then
        return 0
    fi
    return 1
}
if is_big 150; then
    echo "больше 100"
fi
is_big 5
echo "Код: $?"

Ответ:

больше 100
Код: 1

Код функции проверяют так же, как код любой команды: через if или через $? сразу после вызова. Подробнее — в статье Код возврата.

Число больше 255 через return не передать: bash оставит от него только младшие восемь бит, и return 300 вернёт 44.

Вернуть результат: echo

return передаёт только код, а не текст. Чтобы получить из функции результат, выведите его через echo и заберите подстановкой команды $( ):

#!/bin/bash
sum() {
    echo $(( $1 + $2 ))
}
result=$(sum 2 3)
echo "Сумма: $result"

Ответ:

Сумма: 5

Как работает $( ) — в статье Подстановка команд, как считать — Арифметика в bash.

Пример: журнал резервной копии

Функция log дописывает строку в файл журнала и ставит перед ней дату и время. Её вызывают в нужных местах скрипта:

#!/bin/bash
log() {
    echo "$(date '+%F %T') $1" >> "$HOME/backup.log"
}
log "Копия начата"
tar -czf "$HOME/site.tar.gz" -C /var/www site
log "Копия готова"

date '+%F %T' выводит дату в виде год-месяц-день и время в виде часы:минуты:секунды — подробнее в статье Команда date. Журнал посмотрите командой cat ~/backup.log. Как настроить копии целиком — Резервные копии сайта.

Учтите: exit внутри функции завершает весь скрипт, а return — только функцию.

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

Что видноЧто значитЧто сделать
command not found на имени функциифункция объявлена ниже вызоваперенесите объявление выше первого вызова
bash сообщает об ошибке в конце файлаперед } нет ; или перевода строкипишите { команда; }
функция испортила переменную скриптапеременная внутри без localобъявите её как local имя=значение
$1 внутри функции пустойаргументы скрипта в функцию сами не попадаютпередайте их явно: show "$@"
return вернул не то числочисло больше 255выведите результат через echo
скрипт закончился посреди функциив функции стоит exitзамените его на return

Источники

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

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

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