【VS Code】右下に「Todo-Tree: Failed to find vscode-ripgrep」の通知が出てくる原因と解消法

検証環境

• VS Code 1.122.0
• Windows 11

いつからかVS Codeを開くと右下にVS Code拡張機能「Todo Tree」のエラー通知が出ていてTodo Treeが使えなくなっていたので解消方法をまとめておきます。

原因

VS Codeに統合されているripgrep¹の場所がVS Codeのアップデートで変更されたため、ripgrepを使用している Todo Treeがripgrepを参照できなくなり発生しています。

Todo-Tree: Failed to find vscode-ripgrep - please install ripgrep manually and set 'todo-tree.ripgrep' to point to the executable

解消方法

1. 代替となるVS Code拡張機能「Better Todo Tree」に乗り換える

Todo Treeは現在メンテナンスされておらず、このエラーが解消されることはなさそうです。
「Better Todo Tree」はTodo Treeの独立したフォークでバグの修正や高速化が行われています。
設定もそのまま引き継げるので新しいTodo Treeとして使えそうです。

2. Todo TreeにVS Codeのripgrep実行ファイルを手動で設定する

VS Codeの設定からtodo-tree.ripgrep.ripgrepに直接VS codeのripgrep実行ファイルを指定します。
私の場合はScoopでVS Codeをインストールしているため下記の実行ファイルを指定しました。

C:\Users\user\scoop\apps\vscode\1.129.1\8a7abeba6e\resources\app\node_modules.asar.unpacked\@vscode\ripgrep-universal\bin\win32-x64\rg.exe

3. ripgrepをインストールしてTodo Treeに設定する

ripgrepをPCにインストールし、実行ファイルをtodo-tree.ripgrep.ripgrepに指定します。

C:\Users\user\scoop\shims\rg.exe

まとめ

2の方法はVS Codeのフォルダにコミットハッシュが含まれているため、VS Codeのバージョンが上がるたびに設定し直す必要があり、VS Codeは基本最新のバージョンに更新したい派の私には面倒でした。
3の方法もVS Code外でツールを管理する必要があるため、Todo Treeに未練がなければ「Better Todo Tree」に乗り換えるのが今のところベストだと思います。

参考

• [VSCode]動かなくなったTodo Treeを使えるようにする
• GitHub issue - vscode | [Regression 1.122.0] Bundled ripgrep binary path changed, breaking extensions that resolve rg via vscode.env.appRoot (Todo-Tree, Roo Code/Zoo Code)
• GitHub issue - todo-tree | Failed to find vscode-ripgrep

1. 正規表現を使ってファイルやディレクトリの中身を高速に検索できるオープンソースのコマンドラインツールです。 ↩