Zenn
🕌

ASDF Node.js Shim エラー解決手順

に公開
asdf
Node.js
tech

下記のなぞエラーに遭遇したため、対応をメモ

エラー

ASDFのコア機能（asdf current、asdf plugin listなど）は動作する。
しかし特定のツール（nodeなど）のシムが正しく機能しない

症状

  • エラーメッセージ: ***/.asdf/shims/node: line 6: /opt/homebrew/opt/asdf/libexec/bin/asdf: No such file or directory
  • nodeコマンドが実行できない

原因

ASDFのシム（shim）が正しく設定されていなかったことが原因、らしい、、、

解決手順

1. シムの再生成

asdf reshim nodejs
  • 目的：既存のシムを再構築
  • 既存のシムリンクを再作成

2. ASDFパスの明示的設定

~/.zshrcに以下を追加:

export ASDF_DIR="/opt/homebrew/opt/asdf/libexec"
export PATH="$ASDF_DIR/bin:$PATH"
  • 目的：ASDFのバイナリパスを明示的に設定
  • システムPATHにASDFディレクトリを追加

3. シェル設定のリロード

source ~/.zshrc
  • 目的：変更した設定を即座に反映
  • 新しい環境変数を有効化

4. シムの再作成（再確認）

asdf reshim nodejs
  • 目的：設定変更後のシム再構築
  • 追加の安全確認ステップ

5. パスの確認

which node
asdf which node
  • 目的：正しいNode.jsパスの検証
  • インストールされたNode.jsの位置を確認

Discussion