Функции в bash: как объявить, передать аргументы и вернуть результат
Функция — это кусок скрипта со своим именем. Вы один раз описываете в ней несколько команд, а потом вызываете их одним словом сколько угодно раз. Скрипт становится короче, а ошибку в нём проще найти.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу — инструкция.
- Откройте новый файл в редакторе nano:
nano test.sh. - Вставьте текст скрипта из примера ниже.
- Сохраните файл: Ctrl+O, затем Enter, и выйдите: Ctrl+X — подробнее о nano.
- Запустите скрипт:
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 |
Источники
- Справка bash для Ubuntu 24.04 — функции и их объявление, фигурные скобки как отдельные слова, позиционные параметры внутри функции, local, return и младшие восемь бит кода.
- Справка date для Ubuntu 24.04 — форматы %F и %T.
Сверено 20 октября 2026 года.
Что почитать дальше
- Аргументы скриптаоткуда берутся $1 и $2.
- Код возвратакоды, которые возвращает функция.
- Подстановка командкак забрать результат функции.
- Переменные в bashпеременные и их значения.