rg (ripgrep) コマンドの使い方まとめ

超高速なテキスト検索コマンド rg (ripgrep) にはずっとお世話になっていますが、ちょっと凝った検索をしようとしたときに、オプションを忘れてしまうことが多いので、チートシートの形でまとめておきます。 rg は Windows でも macOS/Linux でもほぼ同じように使えるので、使いこなせるようになると便利です。

Ripgrep チートシート

検索パターン

rg "^def "

カレントディレクトリ以下のすべてのファイルから、行頭が def で始まる行を検索します。 rg はデフォルトで、入力パターンを正規表現として扱います。

rg -F "*****"

検索文字列を正規表現として解釈せず、そのままの文字列 (Fixed String) として検索します。上記の例では、***** という文字列を検索します。

rg -i "PATTERN"

大文字・小文字を区別せずに「PATTERN」を検索します。

rg -w "PATTERN"

単語単位で「PATTERN」を検索します。例えば PATTERNS や MYPATTERN はマッチしません（安心してください、TODO: にはマッチします）。 -w オプションの代わりに、正規表現の単語境界 \b を使って、rg "\bPATTERN\b" とすることもできます。

対象ファイル／ディレクトリの絞り込み

rg PATTERN path/to/dir

path/to/dir ディレクトリ以下（あるいは同名のファイル）で「PATTERN」を検索します。 ディレクトリであることを明示したい場合は、末尾にスラッシュを付けます（path/to/dir/）。

rg -t py PATTERN

rg -t sh PATTERN

Python ファイル（拡張子 .py）やシェルスクリプト（拡張子 .sh や .zsh）のみを検索対象にします。 ここで指定するタイプは拡張子ではなくファイルタイプです。指定できるファイルタイプの一覧は rg --type-list で確認できます。 逆に、特定のファイルタイプを除外したい場合は -T py のように大文字の -T を使います。例えば -T minified と指定すると min 系のファイル (minified: *.min.css, *.min.html, *.min.js) を除外できます。

rg -g "*.{js,ts}" PATTERN

glob パターンで指定したファイルのみを検索対象にします。引数がシェルによって展開されないように、必ずクォートで囲みます。 大文字小文字を区別せずにマッチさせたい場合は、-g の代わりに --iglob を使います。 glob パターンを ! で始めると、指定したパターンにマッチするファイルやディレクトリを検索対象から除外できます（zsh による履歴展開が働かないようにするためには、パターンをシングルクォートで囲みます）。

• glob パターンの例:
  • -g '*.{js,ts}' … 拡張子が .js または .ts のファイルを検索
  • -g '*test*' … ファイル名に test を含むファイルを検索
  • --iglob '*test*' … ファイル名に test を含むファイルを検索（大文字小文字を区別しない）
  • -g '**/hoge/**/*.py' … 任意の階層の hoge ディレクトリ以下の .py ファイルを検索
  • -g '**/hoge/*.py' … 任意の階層の hoge ディレクトリ直下の .py ファイルを検索
  • -g 'hoge/**' … この階層の hoge ディレクトリ以下のファイルを検索
  • -g 'hoge/*' … この階層の hoge ディレクトリ直下のファイルを検索
  • -g '!*.min.js' … 拡張子が .min.js のファイルを検索対象から除外
  • -g '!hoge/' … この階層の hoge ディレクトリを検索対象から除外
  • -g '!**/hoge/' … 任意の階層の hoge ディレクトリを検索対象から除外

rg --hidden PATTERN

隠しファイル・隠しディレクトリも検索対象に含めます。 ただし、ドットファイルだけを検索したい場合は、-g ".*" のように glob パターンを使う方がよいです。

rg --no-ignore PATTERN

.gitignore や .ignore、$HOME/.rgignore などで無視されているファイル・ディレクトリも検索対象に含めます。

rg --max-depth 1 PATTERN src/

src/ ディレクトリの直下だけを検索対象にします。サブディレクトリは検索されません。

表示オプション

rg -C2 PATTERN

マッチした行の前後 2 行も一緒に表示します（-A2 -B2 と指定するのと同様）。

rg -c PATTERN

ファイルごとにマッチした行数のみを表示します。

rg -l PATTERN

ファイル名のみを表示します。

どのファイルが検索対象になっているかを調べる (--files)

--files オプションを使うと、実際にどのファイルが検索対象になっているかを確認できます。 試行錯誤しながら検索条件を調整したいときに便利です。

• rg --files
• rg --files -t js
• rg --files -t js src/
• rg --files --hidden
• rg --files -g "/.*"

これを利用して、ファイル名に特定のパターンを含むファイルの一覧を取得することもできます。

$ rg --files | rg test

具体的な使用例

$ rg -w "TODO" src/

$ rg --iglob '!*test.kt' PATTERN src/

トラブルシュート

Operation not permitted という警告が大量に出る

./Library/Calendars: Operation not permitted (os error 1)

のようなエラーは、アクセス権限のないファイルやディレクトリを検索しようとしたときに出る警告です。 これは標準エラー出力への出力なので、次のように 2> を使ってリダイレクトすればこれらの表示を抑制できます。

$ rg PATTERN 2> /dev/null

glob オプション (-g/--glob) を使って、アクセス権限のないディレクトリを検索対象から除外することもできます。 ! を使うと、指定したパターンにマッチするファイルやディレクトリを検索対象から除外できます。

$ rg -g '!Library/' PATTERN

常に検索対象から除外したいファイルやディレクトリがある場合は、.ignore ファイルや .gitignore ファイルを作成して、そこに除外したいパターンを記述しておくと便利です。

/Downloads/
/Library/
/Movies/

関連記事

• tmux チートシート
• Linuxコマンド: curl コマンドのチートシート
• zsh チートシート
• Gimp チートシート
• SVG チートシート
• D3.js チートシート
• VS Code のショートカットキーを使いこなす（ウィンドウ操作編）