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

Команда xargs: как передать список файлов другой команде

xargs читает список со входа и превращает его в аргументы другой команды. Так список файлов, который нашли find или grep, передают команде, которая умеет работать только с именами в строке: rm, cp, gzip, sed.

≈ 4 мин чтения
Содержание 11

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

  1. Подключитесь к серверу — инструкция.
  2. Перейдите в папку сайта: cd /var/www/example.com.
  3. Посчитайте строки во всех 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

Источники

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

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

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