Команда xargs: как передать список файлов другой команде
xargs читает список со входа и превращает его в аргументы другой команды. Так список файлов, который нашли find или grep, передают команде, которая умеет работать только с именами в строке: rm, cp, gzip, sed.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу — инструкция.
- Перейдите в папку сайта:
cd /var/www/example.com. - Посчитайте строки во всех PHP-файлах:
find . -name '*.php' -print0 | xargs -0 wc -l. Если файлов несколько, в конце вывода будет общая строкаtotal.
Зачем нужен xargs
Знак | передаёт следующей команде текст, а не аргументы. wc -l с текстом на входе посчитает строки самого списка, а не файлов из него. xargs берёт каждую строку списка и дописывает её в конец команды как имя файла.
Без команды xargs выводит список в одну строку — это то же, что echo.
Имена с пробелами: -print0 и -0
xargs без ключей делит список по пробелам и переводам строк. Файл «мой отчёт.txt» превратится в два имени, мой и отчёт.txt, и команда их не найдёт. Чтобы этого не было, передавайте имена через нулевой байт:
find … -print0 | xargs -0 команда— после find;grep -rlZ 'текст' папка | xargs -0 команда— после grep.
Нулевой байт не может быть частью имени файла, поэтому такой список не ломается.
Ключи xargs
| Ключ | Что делает |
|---|---|
-0 | имена разделены нулевым байтом |
-n 1 | запускать команду для каждого имени отдельно |
-I {} | подставить имя туда, где стоит {}; команда запускается по разу на строку |
-r | не запускать команду, если список пуст |
-t | выводить каждую команду перед запуском |
-p | спрашивать перед каждой командой: выполнить, если ответ начинается с y |
-P 4 | запускать до четырёх команд одновременно |
Имя в середине команды: -I
По умолчанию xargs дописывает имена в конец команды. Если имя нужно в середине или дважды, укажите метку через -I:
find . -name '*.conf' -print0 | xargs -0 -I {} cp {} {}.bakДля каждого файла с окончанием .conf рядом появится копия с окончанием .conf.bak.
Сначала проверить: -t и -p
Перед удалением посмотрите, что будет сделано. -p покажет каждую команду и выполнит её, только если вы ответите y:
find /var/www/example.com/cache -name '*.tmp' -print0 | xargs -0 -p -n 1 rmЕсли всё верно, запустите то же без -p. Ключ -r добавьте, если файлов может не найтись: без него xargs запустит rm без имён, и rm сообщит об ошибке.
Параллельно: -P
Если команд много и каждая работает долго, их можно запускать одновременно. Сжать старые журналы программы, по четыре файла сразу:
find /var/log/myapp -name '*.log' -mtime +7 -print0 | xargs -0 -n 1 -P 4 gzipС -P нужен -n — иначе xargs соберёт все имена в одну команду, и параллельно запускать будет нечего. Не ставьте число больше, чем ядер у сервера: как узнать характеристики сервера.
Замена текста во многих файлах
xargs вместе с grep и sed меняет адрес сайта во всех файлах, где он встречается:
grep -rlZ 'old\.example\.com' /var/www/example.com | xargs -0 sed -i 's/old\.example\.com/new.example.com/g'Подробно о такой замене и о копии перед ней — в статье Команда sed.
Ошибки и как их исправить
| Что видно | Что значит | Что сделать |
|---|---|---|
| No such file or directory для части имени | в имени файла пробел | передайте имена через -print0 и -0 |
| rm или другая команда жалуется, что нет имени файла | список пуст, а xargs всё равно запустила команду | добавьте -r |
| код возврата 123 | одна из команд завершилась с ошибкой | запустите с -t и посмотрите, на каком имени ошибка |
| код возврата 127 | команда не найдена | проверьте имя команды |
с -P 4 работает только одна команда | не задан -n | добавьте -n 1 |
Источники
- Справка xargs для Ubuntu 24.04 — ключи -0, -I, -n, -P, -p, -r и -t, коды возврата.
- Справка find для Ubuntu 24.04 — ключ -print0.
- Справка grep для Ubuntu 24.04 — ключи -r, -l и -Z.
Сверено 19 октября 2026 года.
Что почитать дальше
- Команда findпоиск файлов по имени и дате.
- Команда grepпоиск текста в файлах.
- Команда sedзамена текста.
- Команды Linux для новичкашпаргалка по командам.