
find と xargs の使い方 - ファイル検索から一括処理までの実践レシピ
当サイトは Amazon.co.jp を宣伝しリンクすることで紹介料を得る手段を提供する、Amazonアソシエイト・プログラムの参加者です。価格・在庫はリンク先の最新情報をご確認ください。
「1週間より古いログを消したい」「プロジェクト内の.jsファイルだけを対象に文字列を置き換えたい」「どこかにある巨大なファイルを探したい」。こうした作業で長く使われているのが、findとxargsの組み合わせです。
findは条件に合うファイルを探して一覧にし、xargsはその一覧を別のコマンドの引数に変えて実行します。どちらも古くからあるコマンドですが、条件の書き方には独特のクセがあり、ファイル名に空白が入っていると壊れる、-deleteの位置を間違えると全部消える、といった落とし穴もあります。
この記事では、findの基本の書式から、よく使う条件、AND・OR・NOTの組み立て方、-execとxargsの使い分け、GNU版とmacOS(BSD)版の違い、実務で使うレシピまでを、実際の実行結果を見ながら順に説明します。
先に結論: よく使う書き方の早見表
| やりたいこと | 書き方 |
|---|---|
| 名前で探す | find . -name '*.js' |
| 大文字小文字を区別せずに探す | find . -iname '*.md' |
| ファイルだけ・ディレクトリだけ | find . -type f / find . -type d |
| 1MiBより大きいファイル | find . -type f -size +1M |
| 7日より前に更新されたファイル | find . -type f -mtime +7 |
| 60分以内に更新されたファイル | find . -type f -mmin -60 |
| 直下だけを見る | find . -maxdepth 1 -type f |
| node_modules の中に入らない | find . -name node_modules -prune -o -name '*.js' -print |
| 見つけたファイルにコマンドを実行(まとめて) | find . -name '*.log' -exec ls -l {} + |
| 見つけたファイルにコマンドを実行(1件ずつ) | find . -name '*.log' -exec gzip {} \; |
| 実行前に1件ずつ確認する | find . -name '*.tmp' -ok rm {} \; |
| 見つけたファイルを消す | find . -name '*.tmp' -delete |
xargsと組み合わせる場合は、空白を含むファイル名に備えて、次の形を基本にします。
find . -type f -name '*.md' -print0 | xargs -0 grep -n 'TODO'事故を防ぐための習慣は次の3つです。
-nameに渡すパターンは必ず'*.js'のようにクォートする-deleteやrmを付ける前に、同じ条件を-printだけで実行して一覧を確かめる- xargsに渡すときは
-print0と-0をセットで使う
実行結果を採取した環境
この記事の実行結果は、macOS 27.2の標準の/usr/bin/findと/usr/bin/xargsで、mktemp -dで作った一時ディレクトリの中で採取しました。シェルはzsh 5.9です。
$ sw_vers
ProductName: macOS
ProductVersion: 27.2
BuildVersion: 26B123
$ what /usr/bin/find
/usr/bin/find:
PROGRAM:find PROJECT:shell_cmds-336.40.1macOSのfindとxargsはFreeBSD由来の実装です。Linuxの多くのディストリビューションで使われているのはGNU findutilsのfindとxargsで、オプションや細かい挙動が違うところがあります。GNU版についてはこの記事のために実行しておらず、GNU findutilsのmanページ(man7.org掲載版)の記述に基づいて説明しています。ls -lの出力に含まれるユーザー名はuserに置き換えています。
使ったディレクトリ構成は次のとおりです。
$ find . | sort
.
./docs
./docs/guide.md
./logs
./logs/app-1.log
./logs/app-2.log
./logs/app-3.log
./logs/big.dump
./my docs
./my docs/memo 2026.md
./node_modules
./node_modules/pkg
./node_modules/pkg/index.js
./Report.MD
./src
./src/app.js
./src/lib
./src/lib/todo.txt
./src/lib/util.js
./src/README.mdmy docs/memo 2026.mdは、空白を含むファイル名の罠を試すためにわざと作っています。logs/big.dumpは3MiBのファイルで、app-1.logとapp-2.logは更新時刻を10月1日と11月1日に変えてあります。
find の基本形: 起点・式・アクション
findの書式は次のとおりです。
find [オプション] 起点... [式]- 起点: 探し始めるディレクトリ。複数並べられます
- 式: 条件(テスト)とアクションの組み合わせ。左から順に評価されます
findは起点から下のディレクトリを再帰的にたどり、見つけたファイル1つ1つについて式を評価します。たとえば次のコマンドは、「カレントディレクトリから下で、名前が*.jsに一致するものを表示する」という意味です。
$ find . -name '*.js'
./node_modules/pkg/index.js
./src/lib/util.js
./src/app.js出力の順番は名前順ではなく、ディレクトリをたどった順番です。並べ替えたいときはsortにパイプで渡します。
アクションを書かないと -print が補われる
上の例には「表示する」というアクションを書いていません。macOSのmanページには、-exec、-ls、-print、-print0、-okのいずれも指定されていない場合、式全体が( 式 ) -printに置き換えられると書かれています。POSIXの仕様も同じ考え方です。この「全体を括弧で囲んでから-printを足す」という動きが、あとで説明するORの落とし穴に関わってきます。
macOS では起点を省略できない
GNU findのmanページには、起点を指定しなければ.が仮定されると書かれています。一方、macOSのfindは起点を省略するとエラーになります。
$ find -name '*.js'
find: illegal option -- n
usage: find [-H | -L | -P] [-EXdsx] [-f path] path ... [expression]
find [-H | -L | -P] [-EXdsx] -f path [path ...] [expression]-nameの-nがオプションとして解釈されています。LinuxとmacOSの両方で動かすスクリプトでは、起点の.を省略せずに書いておくのが安全です。
よく使う条件(テスト)
-name と -iname: 名前で探す
-nameはパスの最後の部分(ファイル名)がパターンに一致するかを調べます。パターンにはシェルと同じ*、?、[...]が使えます。-inameは大文字小文字を区別しない版です。
$ find . -iname '*.md'
./Report.MD
./my docs/memo 2026.md
./docs/guide.md
./src/README.md-name '*.md'ならReport.MDは一致しません。-inameはGNU版にもmacOS版にもあり、POSIXでもIssue 8(POSIX.1-2024)で追加されました。
注意: パターンは必ずクォートします。クォートしないと、findに渡る前にシェルが*を展開してしまいます。この問題は後半の「よくあるエラーと対処」で実例を見せます。
-type: 種類で絞る
| 値 | 意味 |
|---|---|
f | 通常のファイル |
d | ディレクトリ |
l | シンボリックリンク |
$ find . -type d
.
./node_modules
./node_modules/pkg
./my docs
./docs
./logs
./src
./src/lib
$ find src -type f -name '*.js'
src/lib/util.js
src/app.js起点をsrcにすると、出力もsrc/から始まります。出力のパスは起点の書き方に合わせて組み立てられます。
-maxdepth と -mindepth: 深さを制限する
-maxdepth 1は起点の直下までしか見ません。-maxdepth 0なら起点そのものだけです。-mindepth 1は起点そのものを対象から外します。
$ find . -maxdepth 1 -type d
.
./node_modules
./my docs
./docs
./logs
./src-maxdepthは条件のように見えますが、実際には探索全体に効く設定です。macOSのmanページには、式の中のどこに書いても式全体に適用されると書かれています。GNU findは-maxdepthのようなオプションを条件より後ろに書くと警告を出す、とmanページに書かれています。どちらの実装でも、起点の直後に書くのが無難です。
-size: サイズで探す
$ find . -size +1M
./logs/big.dump
$ find . -size +2M -exec ls -lh {} \;
-rw-------@ 1 user wheel 3.0M Nov 17 05:10 ./logs/big.dump+は「より大きい」、-は「より小さい」、符号なしは「ちょうど」です。単位は次のとおりです。
| 単位 | 意味 |
|---|---|
| なし | 512バイトのブロック数(切り上げ) |
c | バイト |
k | 1024バイト |
M | 1024k |
G | 1024M |
単位を付けない-size 1は「1バイト」ではなく「512バイトのブロック1個ぶん」です。POSIXの仕様でも、サイズを512で割って切り上げた値と比べると定められています。バイト単位で比べたいときはcを付けます。
GNU版とmacOS版で結果が変わりやすいのが「より小さい」側です。GNU findのmanページは、サイズは次の単位に切り上げてから比べるため、-size -1Mは-size -1048576cと同じではない、と注意しています。切り上げると1バイト以上のファイルはすべて「1M」になるので、GNU版の-size -1Mに一致するのは0バイトのファイルだけ、という計算になります。
macOSで100バイトと600バイトのファイルを置いて試すと、次のように両方とも一致しました。
$ find . -type f -size -1M
./b600.bin
./empty.txt
./small.bin「1MiB未満」を確実に指定したいなら、どちらの実装でも-size -1048576cとバイトで書くのが確実です。
-mtime と -mmin: 更新時刻で探す
-mtimeは日数(24時間単位)、-mminは分単位で、最終更新時刻を比べます。
| 書き方 | 意味 |
|---|---|
-mtime +7 | 経過日数が7より大きい(切り捨てで8日以上) |
-mtime -1 | 経過日数が1より小さい(24時間以内) |
-mtime 0 | 経過日数が0(24時間以内) |
-mmin -60 | 60分以内 |
POSIXの仕様とGNUのmanページは、経過時間を86400秒で割った端数を切り捨ててから比べると定めています。GNUのmanページには、-atime +1に一致させるには少なくとも2日前にアクセスされている必要がある、という例が載っています。
macOSで、12時間前、36時間前、180時間(7.5日)前のファイルを作って試した結果です。
$ find . -type f -mtime 0
./h12.txt
$ find . -type f -mtime 1
./h36.txt
$ find . -type f -mtime -2
./h12.txt
./h36.txt
$ find . -type f -mtime +77.5日前のファイルは-mtime +7に一致しませんでした。端数を切り捨てると7になり、「7より大きい」を満たさないためです。「7日以上前」という感覚で+7と書くと、実際には「8日以上前」になる点に注意してください。
補足: macOSのmanページには「24時間単位に切り上げて比べる」と読める記述がありますが、手元で試した結果は上のとおり切り捨てと同じ動きでした。また、macOS版は-mtime -2hのようにs、m、h、d、wの単位を付けられます。
-newer: 基準のファイルより新しいもの
-newer ファイルは、指定したファイルより後に更新されたものに一致します。
$ find logs -newer logs/app-2.log
logs
logs/app-3.log
logs/big.dumplogsディレクトリ自体も出ているのは、中にファイルを作ったことでディレクトリの更新時刻も新しくなっているからです。ファイルだけが欲しいなら-type fを足します。デプロイの前にtouchで目印のファイルを作っておき、そのあとに変更されたファイルを-newerで拾う、という使い方もできます。
-path と -prune: 特定のディレクトリを除外する
-pathはファイル名だけでなく、パス全体をパターンと比べます。macOSのmanページには、/も普通の文字として扱われ、*が/をまたいで一致すると書かれています。
$ find . -name '*.js' -not -path './node_modules/*'
./src/lib/util.js
./src/app.jsこの書き方は結果としては正しいのですが、findはnode_modulesの中を最後までたどったうえで、1件ずつ「除外」と判定しています。中身が多いと時間がかかります。
ディレクトリの中に入ること自体をやめさせるのが-pruneです。
$ find . -name node_modules -prune -o -name '*.js' -print
./src/lib/util.js
./src/app.jsこの式は次のように読みます。
- 名前が
node_modulesなら、-prune(その中に入らない)。この枝は真になって終わる - そうでなければ(
-o)、名前が*.jsなら-printする
複数のディレクトリを除外するときは、括弧でまとめます。
$ find . -type d \( -name node_modules -o -name logs \) -prune -o -type f -print
./Report.MD
./my docs/memo 2026.md
./docs/guide.md
./src/README.md
./src/lib/util.js
./src/lib/todo.txt
./src/app.js注意: -pruneを使う式では、最後の-printを省略しないでください。省略すると、次のように除外したはずのディレクトリ名そのものが表示されます。
$ find . -path ./node_modules -prune -o -name '*.js'
./node_modules
./src/lib/util.js
./src/app.js前述のとおり、アクションが無いと式全体が( 式 ) -printになります。-pruneの枝も「真」なので、./node_modulesが表示されてしまうのです。
-perm と -user: 権限と所有者で探す
-permはパーミッションで探します。
$ find . -perm 755 -type f
./src/app.js
$ find . -perm -u=x -type f
./src/app.js| 書き方 | 意味 |
|---|---|
-perm 755 | パーミッションがちょうど755 |
-perm -644 | 指定したビットがすべて立っている(ほかのビットは問わない) |
-perm /022(GNU) | 指定したビットのどれかが立っている |
-perm +022(macOS) | 指定したビットのどれかが立っている |
「どれか」の書き方が実装によって違います。GNU findのmanページには、+modeの形は2005年から非推奨で、現在はサポートされていないと書かれています。macOS版では+modeが「どれか」の意味です。グループやその他のユーザーが書き込めるファイルを探す、といった用途で使います。パーミッションのビットの意味はLinux パーミッションの仕組みで説明しています。
-userは所有者で探します。
$ find . -user $(id -un) -name '*.log' | head -3
./logs/app-3.log
./logs/app-2.log
./logs/app-1.log-regex: 正規表現で探す
-regexは、ファイル名ではなくパス全体が正規表現に一致するかを調べます。そのため'.*\.js'のように、先頭から一致させる書き方が必要です。
$ find . -regex '.*\.js'
./node_modules/pkg/index.js
./src/lib/util.js
./src/app.js正規表現の種類が実装によって違います。
- macOS: 既定は基本正規表現(BRE)。
-Eオプションで拡張正規表現(ERE)になる - GNU: 既定はEmacs形式。
-regextypeで種類を変えられる
macOSで+を使った例です。BREでは+が「1回以上」の意味にならないため、-Eを付けたときだけ一致しました。
$ find . -regex '.*/[a-z]+\.js'
$ find -E . -regex '.*/[a-z]+\.js'
./node_modules/pkg/index.js
./src/lib/util.js
./src/app.js-Eは起点より前に書くオプションです。BREとEREの違いは正規表現の実践ガイドで扱っています。
そのほかの条件
| 条件 | 意味 |
|---|---|
-empty | 空のファイルか空のディレクトリ |
-inum n | inode番号がn |
-samefile ファイル | 指定したファイルと同じ実体(ハードリンク) |
-quit | その場で探索を終える |
-inumはハードリンクの調査や、変な文字を含んで名前を打てないファイルの削除に使えます。inodeは、ファイルシステムがファイルごとに割り当てる管理番号です。ls -iで確認できます。
AND・OR・NOT と括弧
条件を並べると、暗黙のANDになります。macOSのmanページに載っている演算子の優先順位は、高いものから次の順です。
( 式 )!または-not-and(-a、または並べて書くだけ)-or(-o)
ANDは左が偽なら右を評価せず、ORは左が真なら右を評価しません。
OR の落とし穴
.jsと.mdを両方探すつもりで、次のように書くと.mdしか出ません。
$ find . -name '*.js' -o -name '*.md' -print
./my docs/memo 2026.md
./docs/guide.md
./src/README.mdANDはORより優先順位が高いので、この式は「-name '*.js'、または(-name '*.md'かつ-print)」と解釈されます。.jsのファイルは左側で真になりますが、そちらには-printが付いていません。さらに-printを明示しているため、式全体に-printが補われることもありません。
ORでまとめたい条件は括弧で囲みます。括弧はシェルにとって特別な文字なので、\(と\)のようにエスケープし、前後に空白を入れます。
$ find . \( -name '*.js' -o -name '*.md' \) -not -path './node_modules/*'
./my docs/memo 2026.md
./docs/guide.md
./src/README.md
./src/lib/util.js
./src/app.js否定は!か-notです。!もシェルによっては履歴展開に使われるため、\!と書いておくと安全です。
$ find . ! -name '*.log' -type f -path './logs/*'
./logs/big.dumpアクション: -print、-delete、-exec、-ok
-print と -print0
-printはパスのあとに改行を付けて出力します。-print0は改行の代わりにNUL文字(バイト値0)を付けます。ファイル名には改行や空白を含められますが、NUL文字は含められないため、-print0の出力なら区切りを取り違えません。xargsの-0と組み合わせる使い方は後で説明します。
-print0はGNU版にもmacOS版にもあり、POSIXでもIssue 8(POSIX.1-2024)で追加されました。
GNU findには、出力の書式を自由に決められる-printfがあります。macOSのfindには無く、使うとエラーになります。
$ find . -name '*.js' -printf '%p\n'
find: -printf: unknown primary or operator-delete: 見つけたものを消す
-deleteは見つけたファイルやディレクトリを削除します。macOSとGNUのどちらのmanページにも、-deleteを使うと自動的に-depth(中身を先に処理し、ディレクトリ自体を後に処理する)が有効になると書かれています。空でないディレクトリは削除できません。
-deleteで一番怖いのは、書く位置です。式は左から評価されるので、-deleteを条件より前に書くと、条件を見る前に削除が実行されます。
$ ls -R
a.log
b.txt
keep
./keep:
c.txt
$ find . -delete -name '*.log'
$ ls -la
total 0
drwxr-xr-x@ 2 user wheel 64 Nov 17 05:16 .
drwx------@ 8 user wheel 256 Nov 17 05:16 ...logだけを消すつもりが、b.txtもkeep/も消えました。macOSのmanページは「-deleteはほぼ必ず最後に置くべき」「迷ったら-deleteの代わりに-printで試す」と警告しています。GNUのmanページにも、-deleteを先頭に置くと起点の下をすべて削除しようとする、と書かれています。
WARNING
-deleteを付ける前に、必ず同じ条件のまま-deleteを-printに置き換えて実行し、表示された一覧が消してよいものだけであることを確認してください。また、GNUのmanページには、-deleteは-depthを伴うため-pruneとは実質的に組み合わせられない、とも書かれています。
-exec ... \; と -exec ... {} + の違い
-execは見つけたファイルに対して任意のコマンドを実行します。{}の部分が見つけたパスに置き換わります。終わりの書き方が2種類あります。
$ find src -name '*.js' -exec echo {} \;
src/lib/util.js
src/app.js
$ find src -name '*.js' -exec echo {} +
src/lib/util.js src/app.js-exec コマンド {} \; | -exec コマンド {} + | |
|---|---|---|
| 実行回数 | 1件につき1回 | できるだけまとめて少ない回数 |
| 速さ | ファイルが多いと遅い | 速い |
{}の位置 | どこにでも書ける | 最後(+の直前)に置く |
| 条件として使えるか | コマンドの終了ステータスが0なら真 | 常に真 |
;はシェルのコマンド区切りなので、\;や';'のようにエスケープします。+の形はxargsと同じく、コマンドラインの長さの上限に収まるようにまとめて実行します。POSIXの仕様では、まとめる量はARG_MAXで制限されると定められています。どちらのmanページにも、+の形でいずれかの実行が0以外で終わればfind自体も0以外で終わる、と書かれています。
\;の形はコマンドの終了ステータスを条件として使えます。たとえば-exec grep -q 'TODO' {} \; -printと書けば、grepが一致したファイルだけが表示されます。
GNU findのmanページは、-execにはセキュリティ上の問題があり、ファイルのあるディレクトリでコマンドを実行する-execdirの方が安全だと説明しています。-execdirはmacOS版にもあります。
-ok: 1件ずつ確認してから実行する
-okは-exec ... \;と同じですが、実行の前に確認を求めます。yと答えたときだけ実行されます。
$ find logs -name 'app-1.log' -ok rm {} \;
"rm logs/app-1.log"? n最後のnは確認に対して入力した文字です。nと答えたので、ファイルは削除されずに残りました。
対象が数件のときの削除や、念のため1件ずつ目で見たいときに使います。
xargs の役割
xargsは、標準入力から読んだ文字列を、指定したコマンドの引数に並べて実行します。
$ find src -name '*.js' | xargs echo
src/lib/util.js src/app.js
$ find src -name '*.js' | xargs -t wc -l
wc -l src/lib/util.js src/app.js
1 src/lib/util.js
1 src/app.js
2 totalコマンドを省略するとechoが使われます。-tは実行するコマンドラインを標準エラー出力に表示するので、何が実行されるかを確かめるのに便利です。パイプで標準出力を次のコマンドに渡す仕組みはパイプとリダイレクトの仕組みで説明しています。
-exec ... {} +で済む場面も多いですが、xargsには次のような利点があります。
- find以外の出力(
git ls-files、grep -lなど)も引数に変えられる -Pで並列に実行できる-nで1回あたりの引数の数を決められる
空白・改行を含むファイル名の罠と -print0 / -0
xargsは既定で、空白、タブ、改行を区切りとして扱います。macOSのmanページにも、xargsは空白・タブ・改行で区切られた文字列を読む、と書かれています。そのため、空白を含むファイル名がばらばらに分かれます。
$ find . -name '*.md' | xargs ls -l
ls: ./my: No such file or directory
ls: 2026.md: No such file or directory
ls: docs/memo: No such file or directory
-rw-------@ 1 user wheel 6 Nov 17 05:10 ./docs/guide.md
-rw-r--r--@ 1 user wheel 2 Nov 17 05:10 ./src/README.md./my docs/memo 2026.mdが./my、docs/memo、2026.mdの3つに分かれ、存在しないファイルとして扱われました。削除のコマンドだった場合、意図しない別のファイルを消す危険もあります。
findの-print0とxargsの-0を組み合わせると、NUL文字だけが区切りになるので、この問題が起きません。
$ find . -name '*.md' -print0 | xargs -0 ls -l
-rw-------@ 1 user wheel 6 Nov 17 05:10 ./docs/guide.md
-rw-r--r--@ 1 user wheel 7 Nov 17 05:10 ./my docs/memo 2026.md
-rw-r--r--@ 1 user wheel 2 Nov 17 05:10 ./src/README.mdGNUのxargsのmanページも、Unixのファイル名には空白や改行が入りうるので既定の動作は問題になりやすく、-0を使う方がよいと勧めています。xargsの-0はPOSIXでもIssue 8で追加されました。
-n: 1回あたりの引数の数
$ printf '1\n2\n3\n4\n' | xargs -n 2 echo
1 2
3 4-n 1にすると1件ずつ実行します。1つのファイルしか受け取らないコマンドに渡すときに使います。
-I: 引数を好きな位置に置く
-I 文字列を指定すると、コマンドの中のその文字列が入力の1行に置き換わります。慣習的に{}がよく使われます。
$ find src -name '*.js' | xargs -I {} cp {} {}.bak
$ find src -name '*.bak'
src/lib/util.js.bak
src/app.js.bak-Iを使うと、1行につき1回実行されます。GNUのmanページには、-Iは-xと-L 1を含み、引用されていない空白では入力が区切られず改行が区切りになる、と書かれています。macOSのmanページによると、macOS版では置き換え後の引数は既定で255バイトまで(-Sで変更可)に制限されます。長いパスを扱うときは気に留めておいてください。
-0と組み合わせることもできます。
$ find . -name '*.md' -print0 | xargs -0 -I {} echo 'file: {}'
file: ./my docs/memo 2026.md
file: ./docs/guide.md
file: ./src/README.md-P: 並列に実行する
-P 数で、同時にいくつまでコマンドを走らせるかを指定します。
$ printf '%s\n' a b c | xargs -P 3 -I {} sh -c 'sleep 1; echo done {}'
done b
done a
done c3つが同時に走るので約1秒で終わり、終わった順に出力されます。GNUのmanページは、並列に動くコマンドが同じ出力先に書くと、出力の順番は不定で混ざる可能性が高いと注意しています。-P 0は、GNU版でもmacOS版でも「できるだけ多く同時に実行する」という意味です。-PはPOSIXには無い拡張です。
-r: 入力が空のときに実行しない
ここもGNU版とmacOS版で既定の動きが違います。
- GNU: 入力が空でも、コマンドを1回は実行する。
-r(--no-run-if-empty)で実行しないようにできる - macOS: 入力が空ならコマンドを実行しない。
-rはGNU版との互換のために受け付けるだけで、何もしない
macOSで試すと、入力が空のときにxargs lsのlsは実行されませんでした(実行されていればカレントディレクトリの一覧が出るはずです)。
$ find . -name 'nomatch' | xargs lsGNU版で-rを付け忘れると、たとえばfind ... | xargs rmで対象が0件のときに引数なしのrmが走ってエラーになります。もっと危ないのはxargs lsやxargs duのように、引数が無いとカレントディレクトリを対象にするコマンドです。LinuxとmacOSの両方で動かすスクリプトでは、xargs -rと書いておくのが安全です。-rはPOSIX.1-2024(Issue 8)にも入りました。
「Argument list too long」との関係
シェルでワイルドカードを展開すると、ファイルが多いときに次のエラーが出ることがあります。
$ /bin/echo $(yes aaaaaaaaaaaaaaaaaaaaaa | head -n 60000) | wc -c
zsh:1: argument list too long: /bin/echo
0コマンドに渡せる引数と環境変数の合計には上限(ARG_MAX)があるためです。この環境ではgetconf ARG_MAXの結果は1048576でした。上の例は23バイトの文字列を6万個渡そうとしており、上限を超えています。
xargsは引数を上限に収まるように分割して、コマンドを複数回実行します。
$ yes aaaaaaaaaaaaaaaaaaaaaa | head -n 60000 | xargs /bin/echo | wc -l
12
$ yes aaaaaaaaaaaaaaaaaaaaaa | head -n 60000 | xargs -n 10000 /bin/echo | wc -l
61行目の出力はechoが実行された回数です。12回になったのは、macOSのmanページにあるとおり-nの既定値が5000で、6万個を5000個ずつ分けたためです。1回あたりのバイト数の上限(-s)の既定値はARG_MAX - 4096と書かれています。GNU版では--show-limitsで、実際に使われる上限を表示できます。
rm *.logがこのエラーで失敗するときは、次のどちらかに書き換えます。
find . -maxdepth 1 -name '*.log' -exec rm {} +
find . -maxdepth 1 -name '*.log' -print0 | xargs -0 rmxargs の終了ステータス
POSIXの仕様では、xargsは実行したコマンドが見つからなければ127、実行できなければ126で終わります。GNUのmanページには、いずれかの実行が255以外の0以外で終わった場合は123、255で終わった場合は124で、255のときはその場で残りの入力を読まずに止まる、と書かれています。macOS版も、コマンドが255で終わると処理を止めます。スクリプトでエラーを検知したいときは、set -euo pipefailと合わせて終了ステータスを確認してください。
実務レシピ
古いログを削除する
まず-printで対象を確認します。
$ find logs -name '*.log' -mtime +7 -print
logs/app-2.log
logs/app-1.log一覧が正しいことを確かめてから、-printを-deleteに置き換えます。
$ find logs -name '*.log' -mtime +7 -delete
$ ls logs
app-3.log
big.dump-type fを足しておくと、名前の一致したディレクトリを巻き込む心配も減ります。毎日自動で消すならcronに登録します。書き方はcrontabの書き方入門を参照してください。cronから実行する場合は、起点を絶対パスで書きます。
拡張子ごとに sed で一括置換する
$ find src -name '*.js' -print0 | xargs -0 grep -n 'const'
src/lib/util.js:1:export const a=1
$ find src -name '*.js' -print0 | xargs -0 sed -i '' 's/const/let/'
$ cat src/lib/util.js
export let a=1先にgrep -nで置換対象の行を確認してからsedを実行しています。macOSのsedは-iの後にバックアップの拡張子を受け取るので、バックアップを作らないなら''を渡します。GNU sedでは書き方が異なるため、使う環境のmanページを確認してください。Gitで管理しているディレクトリなら、置換後にgit diffで差分を確認でき、失敗しても戻せます。
node_modules や .git を除外して検索する
$ find . -name node_modules -prune -o -type f -name '*.js' -print
./src/lib/util.js
./src/app.js.gitも除外したい場合は、括弧でまとめます。
find . -type d \( -name node_modules -o -name .git \) -prune -o -type f -name '*.js' -print大きいファイルを探す
$ find . -type f -size +1M -exec ls -lh {} +
-rw-------@ 1 user wheel 3.0M Nov 17 05:10 ./logs/big.dump
$ find . -type f -print0 | xargs -0 du -k | sort -rn | head -3
3072 ./logs/big.dump
4 ./src/README.md
4 ./src/lib/util.js2つ目はdu -kでキロバイト単位の使用量を出し、大きい順に並べています。ホームディレクトリ全体などを調べる場合は、-size +100Mのように条件で先に絞ると速く終わります。
grep と組み合わせる
文字列を含むファイルを探すだけなら、grep -rで足ります。
$ grep -rl 'TODO' src
src/lib/todo.txtファイルの種類や更新日時で絞り込んでから中身を探したいときに、findと組み合わせます。
$ find src -type f -name '*.txt' -exec grep -l 'TODO' {} +
src/lib/todo.txtgrepに渡すファイルが1つだけになると、grepはファイル名を表示しません。常にファイル名を表示させたいときはgrep -Hを付けます(macOSのgrepのmanページに記載があります)。
並列で画像を変換する
macOS標準のsipsで、PNGをJPEGに4並列で変換する例です。空白を含むファイル名でも動くように、-print0と-0を使い、ファイル名はsh -cの引数として渡しています。
$ find . -name '*.png' -print0 | xargs -0 -n 1 -P 4 sh -c 'sips -s format jpeg "$1" --out "${1%.png}.jpg" >/dev/null' _
$ find . -name '*.jpg' | sort
./a.jpg
./b c.jpg
./sub/d.jpgsh -c '...' _の_は$0に入る名前の代わりで、ファイル名は$1に入ります。${1%.png}は末尾の.pngを取り除くシェルの書き方です。sh -c "sips ... {}"のように{}をスクリプトの文字列の中に直接埋め込むと、ファイル名に含まれる$や;がシェルに解釈されてしまうため、引数として渡す形にしています。
GNU find と macOS(BSD)find の違い
この記事で触れた違いをまとめます。GNU版の列はGNU findutilsのmanページの記述、macOS版の列はmacOS 27.2のmanページと手元での実行結果に基づいています。
| 項目 | GNU find / xargs | macOS find / xargs |
|---|---|---|
| 起点の省略 | 省略すると. | 不可(エラーになる) |
-regexの既定 | Emacs形式(-regextypeで変更) | BRE(-EでERE) |
-printf | あり | なし |
ビットのどれかが立っている-perm | -perm /mode(+modeは廃止) | -perm +mode |
-size -1M | 0バイトのファイルだけが一致(切り上げのため) | 1MiB未満が一致 |
-mtimeの単位付き指定 | manに記載なし | -mtime -2hなどが使える |
-maxdepthを条件の後ろに書く | 警告が出る | 警告なし |
-delete、-print0、-iname、-mmin、-execdir | あり | あり |
| xargsの入力が空 | 1回実行する(-rで抑止) | 実行しない(-rは何もしない) |
xargs -d(区切り文字の指定) | あり | なし |
xargs -I | -xと-L 1を含む | -xを含む、置換後は既定255バイトまで |
xargs -J(引数を1か所に差し込む) | manに記載なし | あり |
POSIXの仕様(POSIX.1-2024)には、-maxdepth、-delete、-regex、-mminは含まれていません。移植性を最優先するスクリプトでは、これらに頼らない書き方を選ぶことになります。
代替ツール: fd と ripgrep の --files
findの代わりに使われるコマンドとして、fdとripgrep(rg)があります。手元にHomebrewで入っていた版(fd 10.3.0、ripgrep 15.1.0)で試しました。
$ fd -e js
node_modules/pkg/index.js
src/app.js
src/lib/util.js
$ rg --files -g '*.js'
src/app.js
src/lib/util.js
node_modules/pkg/index.jsどちらも既定で隠しファイルと.gitignoreに書かれたファイルを無視します。Gitリポジトリにして.gitignoreにnode_modules/を書くと、node_modulesの中は出なくなりました。
$ fd -e js
src/app.js
src/lib/util.js普段の検索はこれらの方が短く書けて速い一方、どのサーバーにも入っているとは限りません。サーバー上のスクリプトや、.gitignoreの内容に関係なくすべてのファイルを対象にしたい処理ではfindを使う、という使い分けになります。
よくあるエラーと対処
クォートし忘れでシェルがワイルドカードを展開する
カレントディレクトリにa.jsとb.jsがあるときに、パターンをクォートせずに書いた例です。
$ ls
a.js b.js sub
$ find . -name *.js
find: b.js: unknown primary or operatorシェルが*.jsをa.js b.jsに展開したため、findにはfind . -name a.js b.jsが渡り、余ったb.jsを条件として解釈できずにエラーになりました。GNU findでは、同じ状況で次のメッセージが出るとmanページに書かれています。
find: paths must precede expression
find: possible unquoted pattern after predicate `-name'?もっと気づきにくいのは、一致するファイルが1つだけのときです。srcの直下にはapp.jsしかないので、展開されるとfind . -name app.jsになり、エラーにならずに結果が欠けます。
$ cd src && find . -name *.js
./app.js本来は./lib/util.jsも出るはずです。なお、zshは一致するファイルが無いとno matches foundでコマンド自体を止めます。どのシェルでも、パターンは'*.js'か\*.jsのように書いてください。
Permission denied を抑える
読めないディレクトリがあると、findはエラーを出して先へ進みます。
$ find /private/var/root -name x
find: /private/var/root: Permission denied画面が埋まるときは、標準エラー出力を捨てます。
$ find / -maxdepth 3 -name 'sudoers' 2>/dev/null
/private/etc/sudoers注意: 2>/dev/nullは、Permission denied 以外のエラーもすべて捨てます。また、エラーを捨ててもfindの終了ステータスは1のままでした。set -eのスクリプトで使うと、結果が出ていてもそこで止まることがあります。読めないとわかっているディレクトリは、-pruneで先に除外する方が確実です。
-exec の終わりを忘れる
$ find src -name '*.js' -exec echo {}
find: -exec: no terminating ";" or "+"-execの最後には\;か{} +が必要です。;をエスケープし忘れても、シェルがコマンドの区切りとして消費してしまい、同じエラーになります。
-delete の位置を間違える
前述のとおり、-deleteを条件より前に書くと、条件に関係なくすべてを削除します。削除の前に-printで確認する手順を省かないでください。
-name にパスを渡してしまう
-nameが比べるのはファイル名だけです。-name 'src/*.js'のように/を含むパターンは、ファイル名に/が含まれることは無いため、何にも一致しません。ディレクトリを含めて絞りたいときは-path './src/*.js'を使います。
まとめ
- findは「起点」と「式(条件とアクション)」で書く。macOSでは起点の
.を省略できない -nameのパターンは必ずクォートする。クォートし忘れはエラーになるか、黙って結果が欠ける-mtime +7は端数切り捨てで「8日以上前」。-sizeの単位なしは512バイトのブロック数- ディレクトリを除外するなら
-not -pathより-pruneの方が速い。-pruneの式では最後に-printを書く - ORは括弧
\(\)でまとめる。ANDの方が優先順位が高い -deleteは式の最後に置き、先に-printで一覧を確認する-exec ... \;は1件ずつ、-exec ... {} +はまとめて実行する- xargsに渡すときは
-print0と-0をセットにする。空白入りのファイル名で壊れない - 入力が空のときの動きはGNUとmacOSで違う。両方で動かすなら
xargs -rと書いておく - 「Argument list too long」は、
-exec ... {} +かxargsに書き換えれば回避できる
同じ「ファイルをまとめて扱う」コマンドとして、ディレクトリの同期にはrsync の使い方も参考にしてください。
参考資料
- find(1) - Linux manual page(GNU findutils、man7.org)
- xargs(1) - Linux manual page(GNU findutils、man7.org)
- find - The Open Group Base Specifications Issue 8(POSIX.1-2024)
- xargs - The Open Group Base Specifications Issue 8(POSIX.1-2024)
- find(1) - FreeBSD Manual Pages
- xargs(1) - FreeBSD Manual Pages
- apple-oss-distributions/shell_cmds(GitHub)
- sharkdp/fd(GitHub)
- BurntSushi/ripgrep(GitHub)


