grep と ripgrep の使い方 - よく使うオプションと正規表現、使い分けの目安

grep と ripgrep の使い方 - よく使うオプションと正規表現、使い分けの目安

作成日:
読了:約55分
更新日:

当サイトは Amazon.co.jp を宣伝しリンクすることで紹介料を得る手段を提供する、Amazonアソシエイト・プログラムの参加者です。価格・在庫はリンク先の最新情報をご確認ください。

「ログからERRORの行だけを抜き出したい」「プロジェクトのどこで関数を呼んでいるか探したい」「設定ファイルに特定の値が書かれているかをスクリプトで確かめたい」。こうした作業で毎日のように使うのがgrepです。最近は、プロジェクト内の検索にripgrep(コマンド名はrg)を使う人も増えています。

grepは古くからあるコマンドですが、正規表現の種類が3つある、macOSとLinuxでオプションの挙動が違う、マッチしないと終了ステータスが1になってスクリプトが止まる、といった落とし穴があります。ripgrepは便利な反面、既定で.gitignoreのファイルや隠しファイルを検索しないため、「あるはずの文字列が見つからない」と戸惑うことがあります。

この記事では、grepのよく使うオプションと正規表現の違い、シェルスクリプトでの使い方、GNU版とmacOS版の違いを説明したあと、ripgrepの既定の挙動とgrepからの読み替え方、2つの使い分けの目安までを、実際の実行結果を見ながら順に説明します。

先に結論: よく使う書き方の早見表

やりたいことgrepripgrep
ファイルから文字列を探すgrep ERROR app.logrg ERROR app.log
大文字小文字を区別しないgrep -i error app.logrg -i error app.log
一致しない行を出すgrep -v INFO app.logrg -v INFO app.log
行番号を付けるgrep -n ERROR app.logrg -n ERROR app.log
一致した行数を数えるgrep -c ERROR app.logrg -c ERROR app.log
単語として一致させるgrep -w cat words.txtrg -w cat words.txt
一致した部分だけを出すgrep -o 'host=[a-z0-9]*' app.logrg -o 'host=\w+' app.log
前後の行も出すgrep -C 2 ERROR app.logrg -C 2 ERROR app.log
ディレクトリの下を再帰的に探すgrep -rn TODO .rg TODO
一致したファイル名だけを出すgrep -rl TODO .rg -l TODO
正規表現を使わず文字どおりに探すgrep -F 'a.b' filerg -F 'a.b' file
拡張正規表現を使うgrep -E '[0-9]{4}ms' app.logrg '[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.logrg -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=db02
ps aux | grep nginx
git log --oneline | grep fix

grepは「パターンに一致する部分を含む行」を表示します。行の一部が一致すれば、行全体が出力されます。パイプの仕組みはパイプとリダイレクトの仕組みで説明しています。

よく使うオプション

-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 error

find ... -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 error

grepは.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 error

2つ目の{.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で規定
-PPerl互換正規表現(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=2

BREの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=db02

BREの\|は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 1200

egrep と 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=db02

Homebrew版はGNU grepがggrepという名前で入っているため、警告の中もggrep -Eになっています。古いスクリプトにegrepが残っていると、CIのログに警告が並ぶことになるので、grep -Eに書き換えておきます。

終了ステータスとシェルスクリプトでの使い方

GNU grepのマニュアルでは、終了ステータスは次のように決められています。

終了ステータス意味
01行以上が一致した
11行も一致しなかった
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=2

3つ目は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"
fi

set -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=1

grep -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 matches

GNU grep 3.12では次のようになります。

$ grep TODO data.bin
grep: data.bin: binary file matches

GNU 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.12macOS 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はディレクトリを検索するとき、既定で次のものを無視します。

  1. .gitignore、.ignore、.rgignoreのパターンに一致するファイルとディレクトリ
  2. 隠しファイルと隠しディレクトリ
  3. バイナリファイル(NUL文字を含むファイル)
  4. シンボリックリンクの先(たどらない)

grepでgrep -r TODOしたときと同じディレクトリで、rg TODOを実行した結果です。

$ rg TODO
src/app.js:// TODO: handle error

node_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: cache

ripgrep 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.log

GUIDE.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=1

grepの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=0

grep から rg への読み替え早見表

greprg補足
grep -rn PAT .rg PATrgは既定で再帰。端末では行番号付き
grep -rn PAT .(すべてのファイル)rg -uuu PAT除外設定・隠しファイル・バイナリを含める
grep -E PATrg PAT+などにバックスラッシュが要らない点はEREと同じ
grep -P PATrg -P PATrgはPCRE2を使うビルドが必要
grep -F PATrg -F PAT同じ
grep -i / -w / -x / -v / -c / -l / -o同じ文字意味もほぼ同じ
grep -A / -B / -C同じ文字同じ
grep -h(ファイル名を付けない)rg -Irgの-hは短いヘルプ
grep -Hrg -H同じ
grep -R(リンクをたどる)rg -Lrgの-Lはgrepの-Lと意味が違う
grep -L(一致しないファイル)rg --files-without-match
grep -I(バイナリを無視)rg PAT(既定)rgの-Iはファイル名を付けない
grep -r で再帰rg PATrgの-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 PATrgの-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 -uuurgの既定のフィルタを意識しなくてよい

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 outside

GNU grepのマニュアルにあるとおり、-rはコマンドラインで指定したリンクはたどり、再帰中に見つけたリンクはたどりません。すべてのリンクをたどるのは-Rです。

macOSのgrepでは、コマンドラインで指定したリンクもたどりませんでした。

$ grep -r TODO linked
 
$ grep -rS TODO --include="*.txt" .
./linked/ext.txt:TODO outside

macOSの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"; done

GNU grepのマニュアルによると、grepの標準出力は、端末に出すときは1行ごとに、それ以外(パイプやファイル)のときはバッファがいっぱいになるまでためてから書き出されます。macOSのmanページにも同じ説明があります。パイプの先に1行ずつ渡したいときは--line-bufferedを付けます。

tail -f app.log | grep --line-buffered ERROR | while read -r line; do echo "alert: $line"; done

ripgrepにも--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 の使い方もあわせて参考にしてください。

参考資料

tar コマンドの使い方 - tar.gz の作成・展開・一覧から除外、ssh 転送、GNU tar と macOS の bsdtar の違いまで

tar コマンドの使い方 - tar.gz の作成・展開・一覧から除外、ssh 転送、GNU tar と macOS の bsdtar の違いまで

約57分

tarコマンドの使い方を実行結果付きで説明します。tar.gzの作成(-czf)・展開(-xzf)・一覧(-tzf)と展開先の-C、特定ファイルだけの展開、tar(アーカイブ)とgzip(圧縮)の役割の違い、ハイフンなし・短い・長いオプションの書き方と-fの位置の落とし穴、-z・-j・-J・--zstdと-a(--auto-compress)、展開時の圧縮形式の自動判別、圧縮率と速度の比較、--excludeと--exclude-vcs、先頭の/が取り除かれる挙動、--strip-components、-pと--same-ownerによるパーミッションと所有者、圧縮アーカイブに-r・-uが使えない理由、--newer-mtimeと-gによる差分、tar cf - とsshのパイプ転送、GNU tarとmacOSのbsdtar(libarchive)の違い、._ファイルとCOPYFILE_DISABLE・--no-mac-metadata、zipとの違い、信用できないアーカイブの展開時の注意、よくあるエラーの意味と対処までをまとめました。

awk コマンドの使い方 - 列の抽出と集計の基本、-F・連想配列・NR==FNR と gawk・mawk・macOS 版の違い

awk コマンドの使い方 - 列の抽出と集計の基本、-F・連想配列・NR==FNR と gawk・mawk・macOS 版の違い

約62分

awkのパターンとアクションの処理モデル、$0・$1・NF・$NF・NR・FNRとレコード・フィールド、-FとFS・OFS・RS・ORS、$1=$1で行が組み直される挙動、BEGIN/END、printとprintf、比較・正規表現・範囲パターン、連想配列による集計と!seen[$0]++の重複除去、length・substr・split・sub・gsub・matchなどの組み込み関数、-vとENVIRONでのシェル変数の受け渡し、NR==FNRによる2ファイルの突き合わせ、CSVと--csv、gawk・mawk・BusyBox・macOS(BWK awk)の違い、ログ集計やdf・psの加工のレシピとつまずきやすいところを実行結果付きで説明します。

sed コマンドの使い方 - 置換とアドレス指定の基本、-i の GNU 版と macOS 版の違い

sed コマンドの使い方 - 置換とアドレス指定の基本、-i の GNU 版と macOS 版の違い

約50分

sedのパターンスペースとホールドスペースの処理モデル、sコマンドのg・数字・I・p・wフラグと区切り文字の変更、&と\1の後方参照、-n・-e・-f・-E(BREとERE)、行番号・$・/regex/・範囲・!・first~stepのアドレス指定、d・p・a・i・c・y・q・=・rコマンド、-iのGNU版とmacOS版の違いと-n併用で空になる罠、設定ファイルの書き換えやCRLF削除・一括置換のレシピを実行結果付きで説明します。

楽天市場のおすすめPR / 楽天アフィリエイト