grepコマンド｜ファイルの中から文字列を探す

書式

grep [オプション] 探したい文字列 ファイル...

ファイルを1行ずつ見て、一致した行だけを出します。 一致しない行は出ません。

まず打ってみる

このページのターミナルには、ログとソースコードが置いてあります。

$ grep ERROR app.log
ERROR connection refused
ERROR timeout

5行あるログのうち、ERROR を含む2行だけが出ました。 これが grep の基本の働きです。

行番号を出す

-n を付けると、その行がファイルの何行目かが分かります。

$ grep -n ERROR app.log
3:ERROR connection refused
5:ERROR timeout

エディタで開いて直すときに、この番号がそのまま使えます。

大文字と小文字を区別しない

-i を付けると、書き方の揺れを無視して探します。

$ grep -i todo README.md
Todo: write the setup guide.

TODO と書いても Todo と書いてもある、という状況で効きます。

ディレクトリを丸ごと探す

-r を付けると、そのディレクトリの下にあるファイルを全部見ます。 どのファイルの行かも一緒に出ます。

$ grep -r TODO .
./src/index.js:// TODO: handle errors

オプションは組み合わせられます。

$ grep -ri todo src
src/index.js:// TODO: handle errors
src/utils.js:// todo: add tests

一致しない行を出す

-v は結果をひっくり返して、一致しなかった行を出します。

$ grep -v INFO app.log
WARN  slow query
ERROR connection refused
ERROR timeout

ログから通常のログを取り除いて、異常だけを残す、という使い方ができます。

実務での使いどころ

grep は、大量の中から自分に関係のある行だけを引き抜くために打ちます。

件数だけを見るときは -c を使います。

$ grep -c ERROR app.log
2

つまずきやすいところ

何も出ないのは、エラーではなく「無かった」です。

$ grep nope app.log

打ち間違いを疑う前に、大文字小文字（-i）と、探す場所が合っているかを確かめてください。

空白や記号を含む文字列は引用符で囲みます。 grep connection refused app.log と書くと、refused がファイル名として扱われます。 grep "connection refused" app.log と囲めば1つの文字列になります。

探しているのは中身であって、ファイル名ではありません。 名前で探したいときは find です。