
grep と ripgrep の使い方 - よく使うオプションと正規表現、使い分けの目安
当サイトは Amazon.co.jp を宣伝しリンクすることで紹介料を得る手段を提供する、Amazonアソシエイト・プログラムの参加者です。価格・在庫はリンク先の最新情報をご確認ください。
「ログからERRORの行だけを抜き出したい」「プロジェクトのどこで関数を呼んでいるか探したい」「設定ファイルに特定の値が書かれているかをスクリプトで確かめたい」。こうした作業で毎日のように使うのがgrepです。最近は、プロジェクト内の検索にripgrep(コマンド名はrg)を使う人も増えています。
grepは古くからあるコマンドですが、正規表現の種類が3つある、macOSとLinuxでオプションの挙動が違う、マッチしないと終了ステータスが1になってスクリプトが止まる、といった落とし穴があります。ripgrepは便利な反面、既定で.gitignoreのファイルや隠しファイルを検索しないため、「あるはずの文字列が見つからない」と戸惑うことがあります。
この記事では、grepのよく使うオプションと正規表現の違い、シェルスクリプトでの使い方、GNU版とmacOS版の違いを説明したあと、ripgrepの既定の挙動とgrepからの読み替え方、2つの使い分けの目安までを、実際の実行結果を見ながら順に説明します。
先に結論: よく使う書き方の早見表
| やりたいこと | grep | ripgrep |
|---|---|---|
| ファイルから文字列を探す | grep ERROR app.log | rg ERROR app.log |
| 大文字小文字を区別しない | grep -i error app.log | rg -i error app.log |
| 一致しない行を出す | grep -v INFO app.log | rg -v INFO app.log |
| 行番号を付ける | grep -n ERROR app.log | rg -n ERROR app.log |
| 一致した行数を数える | grep -c ERROR app.log | rg -c ERROR app.log |
| 単語として一致させる | grep -w cat words.txt | rg -w cat words.txt |
| 一致した部分だけを出す | grep -o 'host=[a-z0-9]*' app.log | rg -o 'host=\w+' app.log |
| 前後の行も出す | grep -C 2 ERROR app.log | rg -C 2 ERROR app.log |
| ディレクトリの下を再帰的に探す | grep -rn TODO . | rg TODO |
| 一致したファイル名だけを出す | grep -rl TODO . | rg -l TODO |
| 正規表現を使わず文字どおりに探す | grep -F 'a.b' file | rg -F 'a.b' file |
| 拡張正規表現を使う | grep -E '[0-9]{4}ms' app.log | rg '[0-9]{4}ms' app.log |
| 特定の拡張子だけを探す | grep -rn --include='*.js' TODO . | rg -t js TODO または rg -g '*.js' TODO |
| ディレクトリを除外する | grep -rn --exclude-dir=node_modules TODO . | rg -g '!node_modules/' TODO |
| 一致したかどうかだけを判定する | grep -q ERROR app.log | rg -q ERROR app.log |
複数のパターンのどれかに一致する行を探すときは、次のように書きます。
grep -E 'ERROR|WARN' app.log
grep -e ERROR -e WARN app.log
rg 'ERROR|WARN' app.log覚えておきたい習慣は次の4つです。
- パターンは
'...'のようにシングルクォートで囲む。シェルが*や$を先に解釈しないようにするため +、?、|、{n}を使う正規表現ならgrep -Eを付ける。付けないと普通の文字として扱われる- シェルスクリプトで「含まれているか」を判定するなら
if grep -q ...; thenと書く。マッチしないと終了ステータスが1になり、set -eのスクリプトが止まるため - ripgrepで見つからないときは、
-u、-uu、-uuuを順に付けてみる。.gitignoreや隠しファイルの除外で見えていないことが多い
実行結果を採取した環境
NOTE
2026年11月18日に、GNU grep 3.12に同梱のマニュアル(info grep)、GNU grepのNEWS(変更履歴)、macOSのgrepのmanページ、ripgrepのREADME・GUIDE.md・FAQ.md・CHANGELOG.md・GitHubのリリースページで仕様を確認しました。実行結果は、macOS 27.2、zsh 5.9で採取しています。ripgrepの最新版は、GitHubのリリースページの表示で15.2.0(2026年7月15日公開)です。手元のHomebrewで入っていたのは15.1.0で、実行結果は15.1.0のものです。
使ったコマンドのバージョンは次のとおりです。
$ /usr/bin/grep --version
grep (BSD grep, GNU compatible) 2.6.0-FreeBSD
$ what /usr/bin/grep
/usr/bin/grep:
PROGRAM:grep PROJECT:text_cmds-201
$ grep --version | head -1
grep (GNU grep) 3.12
$ rg --version
ripgrep 15.1.0
features:+pcre2
simd(compile):+NEON
simd(runtime):+NEON
PCRE2 10.45 is available (JIT is available)macOS標準の/usr/bin/grepはFreeBSD由来の実装です。Linuxの多くのディストリビューションで使われているGNU grepは、Homebrewのgrepパッケージ(3.12)で試しました。Homebrewではggrepという名前で入り、/opt/homebrew/opt/grep/libexec/gnubinをPATHの先頭に置くとgrepの名前で使えます。以下、特に断りのない実行結果はmacOSのgrep、GNU grepで実行したものは見出しや本文で「GNU grep」と書きます。
試したファイルは次のようなものです。
$ cat app.log
2026-11-18 09:00:01 INFO server started port=8080
2026-11-18 09:00:05 WARN slow query took 1200ms
2026-11-18 09:01:10 ERROR connection refused host=db01
2026-11-18 09:01:11 info retrying
2026-11-18 09:02:00 ERROR timeout host=db02
2026-11-18 09:03:00 INFO request done status=200
$ cat src/app.js
import { load } from './lib/util.js'
// TODO: handle error
const user = load('user')
console.log(user.name)
$ cat src/lib/util.js
export function load(key) {
// todo: cache
return { name: key }
}ほかに、node_modules/pkg/index.js、隠しディレクトリの.config/settings.ini、logs/old.logにもTODOという文字列を入れてあります。ディレクトリはGitリポジトリにしてあり、.gitignoreにはnode_modules/とlogs/を書いています。
grep の基本形
grepの書式は次のとおりです。
grep [オプション] パターン [ファイル...]ファイルを省略すると、標準入力を読みます。パイプで渡したコマンドの出力から行を絞り込む使い方が、実務では一番多いかもしれません。
$ grep ERROR app.log
2026-11-18 09:01:10 ERROR connection refused host=db01
2026-11-18 09:02:00 ERROR timeout host=db02ps aux | grep nginx
git log --oneline | grep fixgrepは「パターンに一致する部分を含む行」を表示します。行の一部が一致すれば、行全体が出力されます。パイプの仕組みはパイプとリダイレクトの仕組みで説明しています。
よく使うオプション
-i・-v・-n・-c: 大文字小文字、反転、行番号、件数
$ grep -i error app.log
2026-11-18 09:01:10 ERROR connection refused host=db01
2026-11-18 09:02:00 ERROR timeout host=db02
$ grep -c ERROR app.log
2
$ grep -n -v -i -e info -e warn app.log
3:2026-11-18 09:01:10 ERROR connection refused host=db01
5:2026-11-18 09:02:00 ERROR timeout host=db02-i: 大文字と小文字を区別しない-v: 一致しない行を出す-n: 行番号を付ける-c: 一致した行の数を出す。1行に2回一致しても1と数える
3つ目は「infoもwarnも含まない行」を、大文字小文字を区別せずに行番号付きで出しています。-eは後で説明する、パターンを複数指定するオプションです。
-w・-x・-o: 単語、行全体、一致した部分
$ grep cat words.txt
cat
catalog
concat
the cat sat
$ grep -w cat words.txt
cat
the cat sat-wは、一致した部分の前後が「単語を作る文字」でないときだけ一致とみなします。GNU grepのマニュアルでは、単語を作る文字は英字、数字、アンダースコアと定められています。catalogやconcatの中のcatは、前後に英字が続くので外れます。
-xは、行全体がパターンと一致する行だけを出します。
$ grep -x " return { name: key }" src/lib/util.js
return { name: key }-oは、行全体ではなく一致した部分だけを1行ずつ出します。ログから値を抜き出して集計するときに便利です。
$ grep -o "host=[a-z0-9]*" app.log
host=db01
host=db02
$ grep -o -w "[A-Z]\{4,5\}" app.log | sort | uniq -c
2 ERROR
2 INFO
1 WARN-A・-B・-C: 前後の行も表示する
-A 数は後ろ(After)、-B 数は前(Before)、-C 数は前後(Context)の行を一緒に出します。
$ grep -A1 WARN app.log
2026-11-18 09:00:05 WARN slow query took 1200ms
2026-11-18 09:01:10 ERROR connection refused host=db01
$ grep -C1 -n refused app.log
2-2026-11-18 09:00:05 WARN slow query took 1200ms
3:2026-11-18 09:01:10 ERROR connection refused host=db01
4-2026-11-18 09:01:11 info retrying-nと組み合わせると、一致した行は3:、前後の行は2-のように、区切りの記号で区別されます。エラーの前後に何が起きていたかを見たいときに使います。
-e・-f: パターンを複数指定する
-eは何回でも指定でき、どれかに一致した行が出ます。パターンをファイルに1行ずつ書いて-fで読ませることもできます。
$ cat patterns.txt
ERROR
WARN
$ grep -c -f patterns.txt app.log
3-eには、-で始まるパターンを渡せるという役割もあります。grep -v opts.txtと書くと-vがオプションとして解釈され、opts.txtがパターンになってしまいます。-eを付けるか、--でオプションの終わりを示します。
$ grep -e -v opts.txt
run with -v option
$ grep -- -v opts.txt
run with -v option-l・-L・-H・-h: ファイル名の出し方
$ grep -rl -i todo src
src/lib/util.js
src/app.js
$ grep -rL TODO src
src/lib/util.js
$ grep -rc TODO src
src/lib/util.js:0
src/app.js:1-l: 一致したファイルの名前だけを出す。GNU grepのマニュアルによると、各ファイルは最初の一致で読むのをやめる-L: 一致しなかったファイルの名前だけを出す-cと-rを組み合わせると、ファイルごとの件数が出る。0件のファイルも出る
検索するファイルが2つ以上あると、行の先頭にファイル名が付きます。1つだけなら付きません。GNU grepのマニュアルにも、-H(ファイル名を付ける)は複数のファイルを探すときの既定、-h(付けない)は1つのファイルか標準入力のときの既定、と書かれています。
$ grep -H TODO src/app.js
src/app.js:// TODO: handle error
$ grep -h TODO src/app.js src/lib/util.js
// TODO: handle errorfind ... -exec grep ... {} +やxargsで渡すと、最後の1回にファイルが1つしか残らないことがあり、その行だけファイル名が付かなくなります。ファイル名を必ず出したいときは-Hを付けておきます。findとの組み合わせ方はfind と xargs の使い方で説明しています。
-r・-R・--include・--exclude・--exclude-dir: 再帰検索と絞り込み
-rはディレクトリの下のファイルを再帰的に探します。GNU grepでは、ファイルを指定しないとカレントディレクトリを探す、とマニュアルに書かれています。macOSのgrepでも、grep -r TODOはカレントディレクトリを探しました。
GNU grepで、隠しファイルも含めて探した結果です(出力はsortで並べ替えています)。
$ grep -r TODO | sort
grep: data.bin: binary file matches
.config/settings.ini:token=TODO
.git/hooks/sendemail-validate.sample: # TODO: Replace with appropriate checks (e.g. spell checking).
.git/hooks/sendemail-validate.sample: # TODO: Replace with appropriate checks for the whole series
.git/hooks/sendemail-validate.sample: # TODO: Replace with appropriate checks for this patch
.git/hooks/sendemail-validate.sample:# Replace the TODO placeholders with appropriate checks according to your
logs/old.log:TODO old log
node_modules/pkg/index.js:module.exports = "TODO in dependency"
src/app.js:// TODO: handle errorgrepは.gitの中もnode_modulesの中も、.gitignoreの内容に関係なくすべて探します。--exclude-dirでディレクトリを、--excludeと--includeでファイル名を絞ります。
$ grep -r TODO --exclude-dir=.git --exclude-dir=node_modules --include="*.js" .
./src/app.js:// TODO: handle error
$ grep -rn --exclude="*.log" --exclude-dir={.git,node_modules} -i todo .
./.config/settings.ini:1:token=TODO
grep: ./data.bin: binary file matches
./src/lib/util.js:2: // todo: cache
./src/app.js:2:// TODO: handle error2つ目の{.git,node_modules}はgrepの機能ではなく、bashやzshのブレース展開です。シェルが--exclude-dir=.git --exclude-dir=node_modulesに展開してからgrepに渡しています。
GNU grepのマニュアルによると、再帰検索中の--excludeと--exclude-dirは、パスの最後の部分(ベース名)とパターンを比べます。--exclude-dir=src/libのようにスラッシュを含むパターンは、再帰中のディレクトリには一致しません。--includeと--excludeが両方一致したときは最後に指定したものが優先され、どちらにも一致しないファイルは、最初の指定が--includeなら除外されます。
--include="*.js"のパターンもクォートします。クォートしないと、シェルが先にワイルドカードを展開しようとします。
-rと-Rの違いはシンボリックリンクの扱いです。これは後半の「よくあるトラブル」で実例を見せます。
-m・-s・--color: そのほかのオプション
-m 数: 一致した行を指定した数だけ出したら終わる。grep -m1 ERROR app.logなら最初の1行だけ-s: 存在しないファイルや読めないファイルについてのエラーメッセージを出さない--color=auto: 一致した部分に色を付ける。autoは標準出力が端末のときだけ色を付ける。GNU grepのマニュアルでは、--colorを付けないときの既定はnever
GNU grepのNEWSによると、3.8で、色を指定する環境変数GREP_COLORは非推奨になりました。代わりにGREP_COLORS='mt=...'の形で指定します。
正規表現の種類: BRE・ERE・PCRE
grepのパターンには、解釈の仕方が4種類あります。
| オプション | 解釈 | 備考 |
|---|---|---|
-G(既定) | 基本正規表現(BRE) | 何も付けないとこれ |
-E | 拡張正規表現(ERE) | POSIXで規定 |
-F | 固定文字列(正規表現として解釈しない) | POSIXで規定 |
-P | Perl互換正規表現(PCRE) | GNU grepの機能。macOSのgrepには無い |
BRE と ERE の違い
GNU grepのマニュアルによると、BREでは?、+、{、|、(、)が特別な意味を持たず、普通の文字として扱われます。BREでこれらの意味を使いたいときは、\?、\+、\{、\|、\(、\)とバックスラッシュを付けます。EREでは逆に、バックスラッシュを付けると普通の文字になります。
$ cat sym.txt
a.b
axb
1+1=2
$ grep "1+1" sym.txt
1+1=2
$ grep -E "1+1" sym.txt
$ grep -E "1\+1" sym.txt
1+1=2BREの1+1は「1+1という文字列」なので一致しました。EREの1+1は「1が1回以上、続いて1」という意味になり、1+1=2には一致しません。
繰り返し回数の指定も同じです。
$ grep -E '[0-9]{4}ms' app.log
2026-11-18 09:00:05 WARN slow query took 1200ms
$ grep '[0-9]\{4\}ms' app.log
2026-11-18 09:00:05 WARN slow query took 1200ms選択(または)も、EREなら記号1つ、BREならバックスラッシュ付きで書きます。
$ grep -E 'ERROR|WARN' app.log
2026-11-18 09:00:05 WARN slow query took 1200ms
2026-11-18 09:01:10 ERROR connection refused host=db01
2026-11-18 09:02:00 ERROR timeout host=db02
$ grep 'ERROR\|WARN' app.log
2026-11-18 09:00:05 WARN slow query took 1200ms
2026-11-18 09:01:10 ERROR connection refused host=db01
2026-11-18 09:02:00 ERROR timeout host=db02BREの\|はGNU grepとmacOSのgrepのどちらでも動きましたが、移植性を考えるなら-Eを付けて書く方が無難です。正規表現そのものの書き方は正規表現の実践ガイドで扱っています。
-F: 記号を含む文字列を探す
.は正規表現で「任意の1文字」です。IPアドレスやファイル名のように.を含む文字列をそのまま探したいときは-Fを付けます。
$ grep "a.b" sym.txt
a.b
axb
$ grep -F "a.b" sym.txt
a.b-P: Perl互換正規表現(GNU grep)
-Pを使うと、\d、先読み(?=...)、\Kなど、Perl系の書き方が使えます。GNU grepのNEWSによると、3.8から-Pは古いPCREではなくPCRE2を使うようになりました。
GNU grepでの実行結果です。
$ grep -P 'took \d+' app.log
2026-11-18 09:00:05 WARN slow query took 1200ms
$ grep -oP 'host=\K\w+' app.log
db01
db02
$ grep -oP '\d+(?=ms)' app.log
1200\Kは「ここまでを一致した部分に含めない」という意味で、-oと組み合わせると値の部分だけを取り出せます。GNU grepのマニュアルには、grep -Pの\dはロケールに関係なくASCIIの数字10個だけに一致する、という注意も書かれています。
macOSのgrepには-Pがありません。
$ grep -P 'took \d+' app.log
grep: invalid option -- P
usage: grep [-abcdDEFGHhIiJLlMmnOopqRSsUVvwXxZz] [-A num] [-B num] [-C[num]]
[-e pattern] [-f file] [--binary-files=value] [--color=when]
[--context[=num]] [--directories=action] [--label] [--line-buffered]
[--null] [pattern] [file ...]macOSで\dの代わりを書くなら、EREの[[:digit:]]や[0-9]を使います。
$ grep -o -E 'took [[:digit:]]+' app.log
took 1200egrep と fgrep は非推奨
egrepはgrep -E、fgrepはgrep -Fの古い別名です。GNU grepのNEWSには、2.5.3(2007年)から非推奨で、3.8(2022年9月2日公開)から「時代遅れなのでgrep -E、grep -Fに置き換えるように」という警告を出すようになった、と書かれています。マニュアルのFAQには、POSIXでは1992年に廃止予定とされ、2001年に削除されたという経緯も載っています。
GNU grep 3.12で実行すると、次の警告が標準エラー出力に出ます。
$ egrep ERROR app.log
egrep: warning: egrep is obsolescent; using ggrep -E
2026-11-18 09:01:10 ERROR connection refused host=db01
2026-11-18 09:02:00 ERROR timeout host=db02Homebrew版はGNU grepがggrepという名前で入っているため、警告の中もggrep -Eになっています。古いスクリプトにegrepが残っていると、CIのログに警告が並ぶことになるので、grep -Eに書き換えておきます。
終了ステータスとシェルスクリプトでの使い方
GNU grepのマニュアルでは、終了ステータスは次のように決められています。
| 終了ステータス | 意味 |
|---|---|
| 0 | 1行以上が一致した |
| 1 | 1行も一致しなかった |
| 2 | エラーが起きた(ファイルが無い、正規表現が不正など) |
macOSのgrepのmanページも同じ0、1、2を挙げています。
$ grep -q FATAL app.log; echo "exit=$?"
exit=1
$ grep "[" app.log; echo "exit=$?"
grep: Invalid regular expression
exit=2
$ grep ERROR app.log nofile.txt; echo "exit=$?"
app.log:2026-11-18 09:01:10 ERROR connection refused host=db01
app.log:2026-11-18 09:02:00 ERROR timeout host=db02
grep: nofile.txt: No such file or directory
exit=23つ目はGNU grepの結果です。一致した行があっても、ファイルが無いというエラーがあれば2になります。-sを付けるとエラーメッセージは消えますが、終了ステータスは2のままでした。
-q: 一致したかどうかだけを判定する
-qは何も出力せず、終了ステータスだけを返します。GNU grepのマニュアルには、一致が見つかった時点で終了し、そのときはエラーがあっても0で終わる、と書かれています。GNU grepで試すと次のとおりです。
$ grep -q ERROR app.log nofile.txt; echo "exit=$?"
exit=0シェルスクリプトで「含まれているか」を判定するなら、ifの条件にそのまま書きます。
if grep -q '^PermitRootLogin no' /etc/ssh/sshd_config; then
echo "root login is disabled"
fiset -e のスクリプトがマッチ0件で止まる
set -e(エラーで止まる設定)のスクリプトでは、「1件も一致しなかった」も失敗として扱われます。次のスクリプトは、FATALが0件だと何も表示せずに終わります。
#!/bin/bash
set -euo pipefail
count=$(grep -c FATAL app.log)
echo "FATAL: ${count}"$ bash check.sh; echo "exit=$?"
exit=1grep -cは0件のときも0を出力しますが、終了ステータスは1です。代入の右辺のコマンドが失敗したため、set -eでそこで止まりました。0件を正常として扱いたいときは、|| trueを付けるか、ifの条件の中で使います。
#!/bin/bash
set -euo pipefail
count=$(grep -c FATAL app.log || true)
echo "FATAL: ${count}"
if grep -q ERROR app.log; then
echo "ERROR found"
fi$ bash check2.sh; echo "exit=$?"
FATAL: 0
ERROR found
exit=0|| trueは終了ステータス2(エラー)も握りつぶしてしまう点に注意してください。ファイルが無いことを検知したいなら、grep ... || [ $? -eq 1 ]のように1だけを許す書き方もあります。set -eとpipefailの動きはset -euo pipefail の使い方で詳しく説明しています。
バイナリファイルと文字コード
Binary file matches
grepは、ファイルにNUL文字(バイト値0)などが含まれているとバイナリファイルとみなし、一致した行を表示せずにメッセージだけを出します。
$ grep TODO data.bin
Binary file data.bin matchesGNU grep 3.12では次のようになります。
$ grep TODO data.bin
grep: data.bin: binary file matchesGNU grepのNEWSによると、3.5からこのメッセージは標準出力ではなく標準エラー出力に出るようになり、文言もBinary file FOO matchesからgrep: FOO: binary file matchesに変わりました。grep パターン ファイル | wc -lの結果にメッセージの1行が混ざらなくなった、とも書かれています。macOSのgrepは古い文言のままです。
扱い方は次の3通りです。
-a(--binary-files=text): テキストとして扱い、行を表示する。制御文字が端末に出るので注意-I(--binary-files=without-match): バイナリファイルは一致しなかったものとして扱う- 既定(
--binary-files=binary): 一致したというメッセージだけを出す
$ grep -I TODO data.bin; echo $?
1再帰検索で画像やビルド成果物に引っかかってメッセージが並ぶときは、-Iを付けると静かになります。
文字コードがロケールと違うファイル
GNU grepのマニュアルでは、「今のロケールの文字コードとして正しくないバイト」もバイナリデータの印とされています。UTF-8の環境でShift_JISのファイルを探すと、ASCIIのERRORを探しているだけでもバイナリ扱いになりました(GNU grep 3.12)。
$ grep ERROR sjis.txt
grep: sjis.txt: binary file matches
$ LC_ALL=C grep ERROR sjis.txt | iconv -f SHIFT_JIS -t UTF-8
エラー ERROR 発生LC_ALL=Cにすると、grepはバイトの並びとして扱うので、行がそのまま出力されます。表示はiconvでUTF-8に変換しました。
macOSのgrepでは、同じファイルに対して何も出力されず、終了ステータスは1でした。
$ grep ERROR sjis.txt; echo "exit=$?"
exit=1
$ LC_ALL=C grep -c ERROR sjis.txt
1メッセージも出ずに「一致なし」になるため、気づきにくい落とし穴です。古いシステムのログやCSVなど、UTF-8でないファイルを探すときはLC_ALL=Cを付けるか、先にiconvでUTF-8に変換してから探します。文字コードの仕組みは文字コードの基本で説明しています。
GNU grep と macOS(BSD)grep の違い
この記事で触れた違いをまとめます。GNU版の列はGNU grep 3.12のマニュアルと実行結果、macOS版の列はmacOS 27.2のmanページと実行結果に基づいています。
| 項目 | GNU grep 3.12 | macOS grep 2.6.0-FreeBSD |
|---|---|---|
-P(PCRE) | あり(PCRE2) | なし(エラーになる) |
| バイナリの一致メッセージ | grep: FILE: binary file matches(標準エラー出力) | Binary file FILE matches |
| ロケールと違う文字コードのファイル | バイナリ扱いでメッセージを出す | メッセージなしで一致しないことがある |
-rとシンボリックリンク | コマンドラインで指定したリンクはたどる。再帰中に見つけたリンクはたどらない | 既定ではどちらもたどらない |
| すべてのリンクをたどる | -R | -S(-Rは-rと同じ) |
egrep、fgrep | 警告を出す(3.8以降) | 警告なし |
GREP_OPTIONS環境変数 | 効かない(NEWSによると3.6以降) | 既定のオプションとして使える |
macOSのgrepのmanページには、long optionはGNU版との互換のために用意されている、と書かれており、--includeや--exclude-dir、--line-bufferedなど多くのオプションは同じ名前で使えます。LinuxとmacOSの両方で動かすスクリプトでは、-Pに頼らず-Eで書くのが安全です。
ripgrep(rg)の基本
ripgrepは、Rustで書かれた検索コマンドです。READMEでは、ディレクトリを再帰的に検索し、既定で.gitignoreの内容を尊重する行指向の検索ツールと説明されています。macOSならbrew install ripgrep、Debian系ならapt-get install ripgrepで入れられることがREADMEに書かれています。
既定で検索しないもの
GUIDE.mdによると、ripgrepはディレクトリを検索するとき、既定で次のものを無視します。
.gitignore、.ignore、.rgignoreのパターンに一致するファイルとディレクトリ- 隠しファイルと隠しディレクトリ
- バイナリファイル(NUL文字を含むファイル)
- シンボリックリンクの先(たどらない)
grepでgrep -r TODOしたときと同じディレクトリで、rg TODOを実行した結果です。
$ rg TODO
src/app.js:// TODO: handle errornode_modulesとlogsは.gitignore、.configと.gitは隠しディレクトリ、data.binはバイナリなので、すべて対象から外れました。プロジェクトのコードを探すときには、これがそのまま望みどおりの結果になります。
なお、.gitignoreの判定には、リポジトリの.gitignoreだけでなく、.git/info/excludeや、Gitのcore.excludesFileで指定した全体の除外設定も使われます(GUIDE.mdに記載)。
-u・-uu・-uuu: フィルタを段階的に外す
-u(--unrestricted)を重ねるごとに、フィルタが外れていきます。GUIDE.mdによると、-uで.gitignoreなどの除外を、-uuでさらに隠しファイルの除外を、-uuuでさらにバイナリの除外を外します。
$ rg -u TODO | sort
logs/old.log:TODO old log
node_modules/pkg/index.js:module.exports = "TODO in dependency"
src/app.js:// TODO: handle error
$ rg -uuu TODO | sort
.config/settings.ini:token=TODO
.git/hooks/sendemail-validate.sample: # TODO: Replace with appropriate checks (e.g. spell checking).
.git/hooks/sendemail-validate.sample: # TODO: Replace with appropriate checks for the whole series
.git/hooks/sendemail-validate.sample: # TODO: Replace with appropriate checks for this patch
.git/hooks/sendemail-validate.sample:# Replace the TODO placeholders with appropriate checks according to your
data.bin: binary file matches (found "\0" byte around offset 11)
logs/old.log:TODO old log
node_modules/pkg/index.js:module.exports = "TODO in dependency"
src/app.js:// TODO: handle error-uuuは、grepのgrep -rに近い対象を探すことになります。個別に外したいときは、--no-ignore(除外設定を使わない)、--hidden(隠しファイルも探す)、-a(バイナリもテキストとして探す)、-L(シンボリックリンクをたどる)を使います。
--hidden は .git の中まで探す
隠しファイルを探したくて--hiddenを付けると、.gitディレクトリの中も対象になります。
$ rg --hidden TODO
src/app.js:// TODO: handle error
.git/hooks/sendemail-validate.sample:# Replace the TODO placeholders with appropriate checks according to your
.git/hooks/sendemail-validate.sample: # TODO: Replace with appropriate checks (e.g. spell checking).
.git/hooks/sendemail-validate.sample: # TODO: Replace with appropriate checks for this patch
.git/hooks/sendemail-validate.sample: # TODO: Replace with appropriate checks for the whole series
.config/settings.ini:token=TODO.gitは.gitignoreに書かれていないので、隠しファイルの除外を外すと見えるようになります。.gitを除いて隠しファイルを探すなら、-gで除外を足します。
rg --hidden -g '!.git/' TODO-t・-T: ファイルの種類で絞る
-t 種類はその種類のファイルだけを、-T 種類はその種類以外を探します。種類ごとの拡張子は--type-listで確認できます。
$ rg --type-list | grep -E "^(js|py|ts):"
js: *.cjs, *.js, *.jsx, *.mjs, *.vue
py: *.py, *.pyi
ts: *.cts, *.mts, *.ts, *.tsx
$ rg -i todo -t js
src/app.js:// TODO: handle error
src/lib/util.js: // todo: cacheripgrep 15.1.0では、jsに*.vueも含まれていました。思っていたファイルが入らない、あるいは余計なファイルが入るときは、--type-listで中身を確かめます。
-g: グロブで絞る
-g(--glob)は、ファイルやディレクトリをグロブのパターンで絞ります。先頭に!を付けると除外です。.gitignoreと同じ書き方で、何回でも指定できます。
$ rg -n -g "*.js" -g "!lib/" -i todo
src/app.js:2:// TODO: handle error!はシェルによっては履歴展開に使われるため、'!lib/'のようにシングルクォートで囲んでおくと安全です。
-S: スマートケース
-S(--smart-case)は、パターンがすべて小文字なら大文字小文字を区別せず、大文字が1文字でも入っていれば区別します。
$ rg -S error app.log
2026-11-18 09:01:10 ERROR connection refused host=db01
2026-11-18 09:02:00 ERROR timeout host=db02
$ rg -S Error app.logGUIDE.mdでは、エイリアスや設定ファイルに入れて使うことが多いと紹介されています。ripgrepは、環境変数RIPGREP_CONFIG_PATHで指定したファイルを設定ファイルとして読みます。1行に1つずつ、--smart-caseのようにオプションを書きます。
--files: 検索対象のファイル一覧
--filesは、検索はせず、ripgrepが検索する予定のファイルを一覧にします。どのファイルが対象になっているかを確かめるのに使えます。
$ rg --files
src/app.js
src/lib/util.js
data.bin
patterns.txt
app.log
words.txt
sym.txt
sjis.txt.gitignoreを尊重したファイル一覧が欲しいときに、findの代わりとしても使えます。data.binのようなバイナリも一覧には出ます(中身を検索するときに除外されます)。
-r: 置換した結果を表示する
-r(--replace)は、一致した部分を置き換えて表示します。grepの-r(再帰)とは意味が違うので注意してください。
$ rg 'host=\w+' -r 'host=MASKED' app.log
2026-11-18 09:01:10 ERROR connection refused host=MASKED
2026-11-18 09:02:00 ERROR timeout host=MASKED
$ rg -o 'host=(\w+)' -r '$1' app.log
db01
db02
$ grep -c MASKED app.log
0$1はキャプチャグループ(括弧で囲んだ部分)の中身です。最後のgrep -cのとおり、ファイル自体は書き換わりません。GUIDE.mdでも、--replaceは出力の一致部分にだけ適用されると説明されています。ファイルを書き換えたいときは、rg -lで対象を絞ってからsedなどで置換します。
--json: 結果をJSONで受け取る
--jsonを付けると、結果を1行1件のJSON(JSON Lines)で出力します。一致した行だけでなく、行番号、ファイル内の位置、一致した部分の開始と終了の位置も含まれます。
$ rg --json -m1 ERROR app.log
{"type":"begin","data":{"path":{"text":"app.log"}}}
{"type":"match","data":{"path":{"text":"app.log"},"lines":{"text":"2026-11-18 09:01:10 ERROR connection refused host=db01\n"},"line_number":3,"absolute_offset":100,"submatches":[{"match":{"text":"ERROR"},"start":20,"end":25}]}}
{"type":"end","data":{"path":{"text":"app.log"},"binary_offset":null,"stats":{"elapsed":{"secs":0,"nanos":113333,"human":"0.000113s"},"searches":1,"searches_with_match":1,"bytes_searched":155,"bytes_printed":280,"matched_lines":1,"matches":1}}}
{"data":{"elapsed_total":{"human":"0.001117s","nanos":1117208,"secs":0},"stats":{"bytes_printed":280,"bytes_searched":155,"elapsed":{"human":"0.000113s","nanos":113333,"secs":0},"matched_lines":1,"matches":1,"searches":1,"searches_with_match":1}},"type":"summary"}jqと組み合わせると、必要な項目だけを取り出せます。
$ rg --json ERROR app.log | jq -r 'select(.type == "match") | .data.line_number'
3
5ファイル名にコロンが含まれていても区切りを取り違えないので、エディタや別のツールに結果を渡すときに向いています。jqの書き方はjq の使い方で説明しています。
正規表現のエンジンと -P
READMEによると、ripgrepの既定の正規表現エンジンはRustのregexクレートです。grepのEREと同じように+や|にバックスラッシュは要らず、\dや\wも使えます。
$ rg 'took \d+ms' app.log
2026-11-18 09:00:05 WARN slow query took 1200ms
$ rg "1+1" sym.txt; echo "exit=$?"
exit=1grepのBREとは違い、1+1は「1が1回以上、続いて1」と解釈されました。記号を文字どおりに探すときは-Fを付けます。
READMEによると、既定のエンジンは先読み・後読みと後方参照に対応していません。使おうとすると、PCRE2を使う-Pを勧めるエラーが出ます。
$ rg '\d+(?=ms)' app.log
rg: regex parse error:
(?:\d+(?=ms))
^^^
error: look-around, including look-ahead and look-behind, is not supported
Consider enabling PCRE2 with the --pcre2 flag, which can handle backreferences
and look-around.
$ rg -o -P '\d+(?=ms)' app.log
1200-Pが使えるかどうかはビルドによります。rg --versionの出力にfeatures:+pcre2とあれば使えます。
複数行にまたがる検索
-U(--multiline)を付けると、改行をまたいで一致させられます。grepは1行ずつ処理するため、同じことは基本的にできません。
$ rg -U 'WARN.*\n.*ERROR' app.log
2026-11-18 09:00:05 WARN slow query took 1200ms
2026-11-18 09:01:10 ERROR connection refused host=db01出力の形式と終了ステータス
端末で実行すると、ripgrepはファイル名を見出しにして、その下に行番号付きで結果をまとめます。
$ rg TODO
src/app.js
2:// TODO: handle errorパイプやファイルに出力すると、grepと同じファイル名:内容の1行形式になり、行番号は付きません。この記事のほかの実行例は、sortに渡す都合などでこちらの形式で載せています。行番号が必要なら-nを付けます。
終了ステータスはgrepと同じで、manページ(rg --generate manで出力できます)には、一致があれば0、無ければ1、エラーなら2と書かれています。-qで一致があった場合はエラーがあっても0です。
$ rg FATAL app.log; echo "exit=$?"
exit=1
$ rg -q ERROR app.log; echo "exit=$?"
exit=0grep から rg への読み替え早見表
| grep | rg | 補足 |
|---|---|---|
grep -rn PAT . | rg PAT | rgは既定で再帰。端末では行番号付き |
grep -rn PAT .(すべてのファイル) | rg -uuu PAT | 除外設定・隠しファイル・バイナリを含める |
grep -E PAT | rg PAT | +などにバックスラッシュが要らない点はEREと同じ |
grep -P PAT | rg -P PAT | rgはPCRE2を使うビルドが必要 |
grep -F PAT | rg -F PAT | 同じ |
grep -i / -w / -x / -v / -c / -l / -o | 同じ文字 | 意味もほぼ同じ |
grep -A / -B / -C | 同じ文字 | 同じ |
grep -h(ファイル名を付けない) | rg -I | rgの-hは短いヘルプ |
grep -H | rg -H | 同じ |
grep -R(リンクをたどる) | rg -L | rgの-Lはgrepの-Lと意味が違う |
grep -L(一致しないファイル) | rg --files-without-match | |
grep -I(バイナリを無視) | rg PAT(既定) | rgの-Iはファイル名を付けない |
grep -r で再帰 | rg PAT | rgの-rは置換表示 |
--include='*.js' | -g '*.js' または -t js | |
--exclude-dir=dist | -g '!dist/' | |
--line-buffered | --line-buffered | 同じ |
LC_ALL=C grep(Shift_JISなど) | rg -E sjis PAT | rgの-Eは文字コードの指定 |
同じ1文字でも意味が違うものがあるので注意してください。特に-r(grepは再帰、rgは置換)、-E(grepはERE、rgは文字コード)、-L(grepは一致しないファイル、rgはリンクをたどる)、-hと-Iは取り違えやすいところです。rgの文字コード指定については、READMEに、UTF-16、latin-1、GBK、EUC-JP、Shift_JISなどを-E(--encoding)で指定して検索できると書かれています。
使い分けの目安
grepとripgrepは、どちらかが上位互換というより、得意な場面が違います。
| 場面 | 向いているもの | 理由 |
|---|---|---|
| サーバー上のシェルスクリプト | grep | ほぼどの環境にも入っている。オプションの多くがPOSIXで決まっている |
| パイプで受けた出力の絞り込み | grep | 書き方はほぼ同じで、ripgrepが無い環境でもそのまま動く |
| プロジェクトのコードを対話的に探す | rg | .gitignoreを尊重し、node_modulesやビルド成果物を勝手に外してくれる |
| 先読みや複数行の一致 | rg(-P、-U) | macOSのgrepには-Pが無い |
| 結果をほかのツールで処理する | rg(--json) | 位置情報まで構造化されている |
.gitignoreに関係なくすべてを探す | grep、またはrg -uuu | rgの既定のフィルタを意識しなくてよい |
ripgrepのREADMEにも、ripgrepを使わない方がよい理由として「どこにでもある移植性の高いツールが必要な場合。ripgrepはPOSIXなどの標準に準拠していないので、その用途にはgrepが一番」と書かれています。FAQでも、grepの完全な置き換えにはならないと明言されています。速さについては、READMEで「一般に速い」と説明されています。この記事では速度は計測していません。
まとめると、次のように分けるのがわかりやすいと思います。
- 人に配るスクリプト、CI、本番サーバーでの処理: grep(
-Eまでにとどめる) - 自分の端末でのコード検索: rg
よくあるトラブル
-r でシンボリックリンクの先を探してくれない
リポジトリの外のディレクトリへのシンボリックリンクlinkedを置いて試しました。
GNU grepの結果です。
$ grep -r TODO --include="*.txt" .
$ grep -R TODO --include="*.txt" .
./linked/ext.txt:TODO outside
$ grep -r TODO linked
linked/ext.txt:TODO outsideGNU grepのマニュアルにあるとおり、-rはコマンドラインで指定したリンクはたどり、再帰中に見つけたリンクはたどりません。すべてのリンクをたどるのは-Rです。
macOSのgrepでは、コマンドラインで指定したリンクもたどりませんでした。
$ grep -r TODO linked
$ grep -rS TODO --include="*.txt" .
./linked/ext.txt:TODO outsidemacOSのmanページでは、-Rと-rは同じ意味で、リンクをすべてたどるのは-S、コマンドラインで指定したものだけをたどるのは-Oです。ripgrepは既定でリンクをたどらず、-L(--follow)でたどります。
リンクをたどると、リンクが親ディレクトリを指している場合に同じ場所を何度も探すこともあります。必要なときだけ付けるようにします。
rg で見つからない
ripgrepで「あるはずの文字列が見つからない」ときは、ほとんどが既定のフィルタのせいです。まず-uを付けてみて、それでも出なければ-uu、-uuuと増やします。
それでも理由がわからないときは--debugを付けると、どのファイルをどの設定で除外したかが表示されます。筆者の環境では、プロジェクトの.gitignoreには書いていないapp.logが、ディレクトリを検索したときだけ出てきませんでした。
$ rg ERROR
patterns.txt:ERROR
sjis.txt:�G���[ ERROR ����
$ rg --debug ERROR 2>&1 | grep 'app.log'
rg: DEBUG|ignore::walk|crates/ignore/src/walk.rs:1942: ignoring ./app.log: Ignore(IgnoreMatch(Gitignore(Glob { from: Some("/Users/user/.gitignore"), original: "*.log", actual: "**/*.log", is_whitelist: false, is_only_dir: false })))ホームディレクトリのパスは/Users/userに置き換えています。Gitのcore.excludesFileに指定していた全体用の~/.gitignoreに*.logが書かれていて、それにripgrepが従っていたのが原因でした。この記事のほかのripgrepの実行例は、この全体設定を読まない状態で採取しています。
対処は次のどれかです。
rg --no-ignore-global ERROR: Gitの全体用の除外設定だけを使わないrg ERROR app.log: ファイルを直接指定する。GUIDE.mdにあるとおり、自動のフィルタはディレクトリをたどって見つけたファイルにだけかかる.ignoreや.rgignoreに!*.logと書いて、除外を打ち消す
なお、ripgrep 15.2.0のCHANGELOGには、Gitの環境変数GIT_CONFIG_GLOBALとGIT_CONFIG_SYSTEMを尊重するようになったと書かれています。.gitignoreが効かない原因の調べ方は.gitignore が効かないときの確認手順も参考にしてください。
上のsjis.txtの行が文字化けしているのは、Shift_JISのファイルをそのまま端末に出したためです。ripgrepでは-E sjisを付けると、UTF-8に変換して表示されます。
パイプの先に出力がなかなか届かない
tail -fで流れてくるログをgrepで絞り込み、さらに別のコマンドに渡すと、結果がなかなか表示されないことがあります。
tail -f app.log | grep ERROR | while read -r line; do echo "alert: $line"; doneGNU grepのマニュアルによると、grepの標準出力は、端末に出すときは1行ごとに、それ以外(パイプやファイル)のときはバッファがいっぱいになるまでためてから書き出されます。macOSのmanページにも同じ説明があります。パイプの先に1行ずつ渡したいときは--line-bufferedを付けます。
tail -f app.log | grep --line-buffered ERROR | while read -r line; do echo "alert: $line"; doneripgrepにも--line-bufferedがあります。CHANGELOGによると、15.0.0で--line-bufferedが正しく効かなくなる不具合が入り、15.1.0で修正されています。
マッチしないと set -e のスクリプトが止まる
前述のとおり、grepは0件のとき終了ステータス1を返します。set -eのスクリプトでgrepの結果を変数に入れたり、パイプの途中に置いたり(pipefailが有効な場合)すると、0件の時点で何も言わずに止まります。判定に使うならif grep -q、件数を取るならgrep -c ... || trueのように、0件を想定した書き方にしておきます。
ps aux | grep で grep 自身が引っかかる
ps aux | grep nginxこの書き方では、grep nginxというプロセス自身も一覧に出てくることがあります。プロセスを探すなら、pgrep -f nginxのように専用のコマンドを使う方が確実です。
文字列探索の仕組みを知りたい
grepやripgrepの裏側にある文字列探索の考え方(KMP法、Boyer-Moore法など)は、文字列検索アルゴリズム入門で説明しています。
まとめ
- grepは「パターンを含む行」を出す。パターンはシングルクォートで囲む
- よく使うのは
-i、-v、-n、-c、-w、-o、-A/-B/-C、-l、-r。複数のパターンは-eか-f - 既定はBRE。
+、?、|、{n}を使うなら-E。記号を文字どおり探すなら-F -PはGNU grepの機能で、macOSのgrepには無い。両方で動かすスクリプトでは使わないegrepとfgrepはGNU grep 3.8から警告が出る。grep -E、grep -Fに書き換える- 終了ステータスは0が一致あり、1が一致なし、2がエラー。
set -eでは1でも止まるので、判定はif grep -qで書く Binary file matchesはNUL文字やロケールと違う文字コードが原因。-Iで無視、-aでテキスト扱い、文字コードの問題ならLC_ALL=C-rと-Rの違いはシンボリックリンク。macOSでは-S- ripgrepは
.gitignore、隠しファイル、バイナリを既定で外す。見つからなければ-uを重ねるか--debug - ripgrepの
-rは置換表示、-Eは文字コード、-Lはリンクをたどる。grepと同じ文字でも意味が違う - スクリプトの移植性ならgrep、プロジェクト内の対話的な検索ならrg
grepで見つけたファイルをまとめて処理するならfind と xargs の使い方、APIのレスポンスから値を抜き出すならcurl の使い方とjq の使い方もあわせて参考にしてください。
参考資料
- BurntSushi/ripgrep(GitHub)
- ripgrep User Guide(GUIDE.md)
- ripgrep FAQ(FAQ.md)
- ripgrep CHANGELOG(CHANGELOG.md)
- ripgrep 15.2.0 リリースページ(GitHub)
- grep - The Open Group Base Specifications Issue 8(POSIX.1-2024)
- grep(1) - FreeBSD Manual Pages
- apple-oss-distributions/text_cmds(GitHub)
- GNU grep 3.12 のマニュアル(
info grep。Homebrewのgrepパッケージに同梱)と、GNU grepのソースに含まれるNEWS


