Аргументы скрипта bash: $1, $#, "$@" и shift
Аргументы — это слова, которые вы пишете после имени скрипта: ./backup.sh example.com. Внутри скрипта они доступны как $1, $2 и дальше. Так один скрипт работает с разными сайтами и файлами, и его не надо править под каждый.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу — инструкция.
- Откройте новый файл в редакторе nano:
nano test.sh. - Вставьте текст скрипта из примера ниже.
- Сохраните файл: Ctrl+O, затем Enter, и выйдите: Ctrl+X — подробнее о nano.
- Запустите скрипт:
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} |
| в цикле аргументы перемешались по словам | взяли $* или $@ без кавычек | пишите "$@" |
Источники
- Справка bash для Ubuntu 24.04 — позиционные параметры, ${10}, специальные параметры $#, $@, $* и $0, команда shift и ${…:-…}.
Сверено 20 октября 2026 года.
Что почитать дальше
- Цикл forперебрать аргументы по одному.
- Условие ifпроверить число аргументов.
- Команда readспросить значение, если аргумент не передали.
- Скрипты bash: первый скрипткак создать и запустить скрипт.
- Ключи скрипта: getoptsразобрать ключи вида -f файл и -v.