🔗

mise で入れた Node や pnpm が VSCode 拡張で使えない時の対処法

に公開1件

問題

mise でインストールした Node.js や pnpm が、VSCode の Jest や Playwright 拡張から“だけ”使えない問題が発生しました。

ターミナルでは動くのに、VSCode 拡張側では以下のようなエラーが出てしまいます。

node: not found
Unable to find 'node' executables.
Your Node version is incompatible with "/Users/xxx".

pnpm: not found
pnpm is not accessible.

解決法 1

mise 公式ドキュメントにも記載がありますが、.zprofile に shims を読み込む設定を追加します。

echo 'eval "$(mise activate zsh --shims)"' >> ~/.zprofile # これを追加実行する
echo 'eval "$(mise activate zsh)"' >> ~/.zshrc    # これはすでに mise インストール時にやっているはず

解決法 2

それでも改善しない場合は、/usr/local/bin に mise の shims へのシンボリックリンクを作成します。
(特に Playwright 拡張は、私の環境では この方法でしか解決しませんでした)

# node が使えない場合
sudo ln -s "$HOME/.local/share/mise/shims/node" /usr/local/bin/node

# pnpm が使えない場合
sudo ln -s "$HOME/.local/share/mise/shims/pnpm" /usr/local/bin/pnpm

解説

エラー原因

mise の通常セットアップでは、.zshrc に eval "$(mise activate zsh)" が追記され、ターミナルのような 対話シェル では node / pnpm の PATH が自動で通るようになります。

しかし VSCode の拡張は多くの場合 非対話シェル で動作するため、.zshrc が読み込まれません。
その結果、mise の PATH が設定されないまま node / pnpm が呼ばれ、上記のエラーにつながります。

解決法 1 の解説

.zprofile に eval "$(mise activate zsh --shims)" を記載する方法です。

.zprofile

.zprofile は ログインシェル で実行されます。

VSCode 拡張の設定次第では .zshrc は読まれなくても .zprofile は読み込まれるケースがあり、この差によって挙動が変わることがあります。

Shims

mise activate zsh --shims は export PATH="$HOME/.local/share/mise/shims:$PATH" と同義で、 PATH に mise の shims ディレクトリを追加します。

Shims は “緩衝材” のような小さなスクリプトで、$HOME/.local/share/mise/shims/node を実行すると、現在のプロジェクト or グローバルに設定された node バージョンへ適切にルーティングしてくれます。

そのため .zprofile が実行される環境では、Shims 経由で node が使用できるようになります。

(対話シェル では Shims ではなく、グローバルバージョンの実体に直接 PATH が通る方式が使われます)

解決法 2 の解説

VSCode 拡張は、zsh ではないシェルで実行されたり、.zprofile すら読み込まれないことがあります。
そのような環境でも、多くの場合 /usr/local/bin は PATH に含まれているため、ここに node / pnpm があれば実行可能になります。

よって、Shims へのシンボリックリンクを /usr/local/bin に作成することで、どのシェル環境からでもグローバル設定の node を実行できるようになります。

sudo ln -s "$HOME/.local/share/mise/shims/node" /usr/local/bin/node

備考

これは mise の推奨方法ではないため、環境によっては副作用が出る可能性があります。

また /usr/local/bin/node は Homebrew が管理する Node と衝突することがあるため、必要に応じて既存バイナリの整理が必要です。

GitHubで編集を提案

Discussion

mitommitom

miseの公式vscode拡張もあるみたいです
参考までに

1