問題

asdf を brew upgrade asdf でアップデートした後、インストール済みのプラグインが利用できなくなる問題が発生しました。

以下のようなエラーメッセージが表示されます:

~/.asdf/shims/node: line 6: /opt/homebrew/opt/asdf/libexec/bin/asdf: No such file or directory
~/.asdf/shims/node: line 6: exec: /opt/homebrew/opt/asdf/libexec/bin/asdf: cannot execute: No such file or directory

v0.14→v0.17（2025.05.25 最新バージョン）にアップデートした際に発生しました。

対処方法

以下の手順で問題を解決できます。

1. asdf のインストールパスを確認

以下のコマンドを実行して、asdf の新しいインストールパスを確認します:

brew --prefix asdf
/opt/homebrew/opt/asdf

2. シムリンクを再生成

asdf のシムリンクを再生成するには、以下のコマンドを実行します:

asdf reshim

これにより、すべてのプラグインのシムリンクが正しいパスで再作成されます。

3. 動作確認

再度、プラグインが正しく動作するか確認します。

node --version
v22.14.0

エラーが表示されず、問題なくバージョンが出力されました

まとめ

brew upgrade asdf 後にプラグインが動作しなくなる問題は、asdf のインストールパス変更が原因です。
asdf reshim コマンドを使用してシムリンクを再生成することで解決できます。

今後、asdf をアップデートする際は、この手順を参考にしてください。