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

Аргументы скрипта bash: $1, $#, "$@" и shift

Аргументы — это слова, которые вы пишете после имени скрипта: ./backup.sh example.com. Внутри скрипта они доступны как $1, $2 и дальше. Так один скрипт работает с разными сайтами и файлами, и его не надо править под каждый.

≈ 3 мин чтения
Содержание 9

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

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

Запустите его с двумя словами: bash test.sh один два. Ответ:

Имя скрипта: test.sh
Первый аргумент: один
Второй аргумент: два
Всего аргументов: 2

Переменные аргументов

ПеременнаяЧто в ней
$0имя скрипта — так, как его запустили
$1 … $9первый … девятый аргумент
${10}десятый и дальше — только в фигурных скобках
$#сколько аргументов передали
"$@"все аргументы, каждый — отдельным словом
"$*"все аргументы одной строкой через пробел

Без фигурных скобок $10 bash поймёт как $1 и следом цифру 0.

Аргумент с пробелом

bash делит строку на аргументы по пробелам. Имя файла с пробелом возьмите в кавычки: bash test.sh "мой файл.txt" — тогда $1 будет мой файл.txt, а $# — 1. Внутри скрипта тоже пишите "$1" в кавычках, иначе имя снова распадётся на два слова.

Перебрать все аргументы

for file in "$@"; do
    echo "Обрабатываю: $file"
done

"$@" в кавычках отдаёт каждый аргумент целиком, даже если в нём пробел. Если написать $* без кавычек, аргумент первый файл распадётся на два слова — первый и файл. Подробнее о циклах — в статье Цикл for.

Проверить, что аргумент передали

#!/bin/bash
if [ $# -lt 1 ]; then
    echo "Укажите папку: $0 /путь/к/папке"
    exit 1
fi
du -sh "$1"

Если скрипт запустили без аргументов, он напишет подсказку и завершится с кодом 1 — по нему другие программы поймут, что скрипт не сработал. О кодах — в статье Код возврата, о проверках — Условие if.

Значение по умолчанию вместо ошибки: dir=${1:-/var/www} — если первый аргумент не передали, в dir будет /var/www.

shift: сдвинуть аргументы

shift убирает первый аргумент: второй становится $1, третий — $2, а $# уменьшается на один. shift 2 убирает сразу два. Если убрать больше, чем есть, аргументы не изменятся, а shift вернёт ненулевой код.

site=$1
shift
echo "Сайт: $site, остальные: $*"

Так удобно, когда первый аргумент особый, например имя сайта, а дальше идёт список файлов.

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

Что видноЧто значитЧто сделать
$1 пустойскрипт запустили без аргументовдобавьте проверку $# или значение по умолчанию
имя файла разбилось на дванет кавычек вокруг $1 или при запускепишите "$1" и "мой файл.txt"
$10 вывел первый аргумент и 0нет фигурных скобокпишите ${10}
в цикле аргументы перемешались по словамвзяли $* или $@ без кавычекпишите "$@"

Источники

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

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

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