目次
はじめに
参画したプロジェクトAのリポジトリ内のREADME.mdに以下の指示が記載されていました。
- node.js ※2025/04時点での最新LTSである22.14.0を利用すること
- yarn ※2025/04時点での最新stableの4.8.1を利用すること
- Corepackの有効化
corepack enable
- 利用バージョンの指定
corepack prepare yarn@4.8.1 --activate
yarn -v すると、1.22.22 と表示されました。
次に、READMEに指定があったので
corepack enable
corepack prepare yarn@4.8.1 --activate
を実行しました。
しかしyarn -vすると、再び1.22.22と表示されてしまいました。
4.8.1になってほしいところ。
原因
Homebrew経由のYarn 1.xがPATH上で先に解決されているため。
| 使用状況 | パス | バージョン |
|---|---|---|
| 使われている | /opt/homebrew/bin/yarn | Yarn Classic(1.22.22) |
| 使われていない | ~/.nodebrew/current/bin/yarn | Corepack(4.8.1) |
後述するPATHで、/opt/homebrew/binが~/.nodebrew/current/binよりもあとに記述されているため、/opt/homebrew/bin(1.22.22)の設定が優先されています。
解決策
非推奨案
HomebrewのYarnを削除する
brew uninstall yarn
別のプロジェクトBでは、Yarn 1.x(Classic)が使われていたので、HomebrewのYarnを消すと影響を及ぼす可能性がありました。
そのためHomebrewのYarnを削除する方法は取らないことにしました。
推奨案
次にパスの設定を確認するために .zshrcファイル を開きます。
※ zshrxファイルとは
macOSのターミナルで使用する 環境変数やPATH(コマンドの検索先)を設定するファイル
.zshrcファイル
export PATH=$HOME/.nodebrew/current/bin:$PATH
export PATH=/opt/homebrew/bin:$PATH
### MANAGED BY RANCHER DESKTOP START (DO NOT EDIT)
export PATH="/Users/user-name/.rd/bin:$PATH"
### MANAGED BY RANCHER DESKTOP END (DO NOT EDIT)
export PATH="$HOME/.rd/bin:$PATH"
↓ 次の2行をピックアップします。
export PATH=$HOME/.nodebrew/current/bin:$PATH
export PATH=/opt/homebrew/bin:$PATH
# これが後に記述されているためhomebrewが優先される
プロジェクトAのディレクトリにいる場合だけnodebrewのPATHを優先したい。
任意のディレクトリの場合だけnodebrewのPATHを優先
# 変更なし(ここから)----------------------------------
export PATH=$HOME/.nodebrew/current/bin:$PATH
export PATH=/opt/homebrew/bin:$PATH
### MANAGED BY RANCHER DESKTOP START (DO NOT EDIT)
export PATH="/Users/yukiyoshi/.rd/bin:$PATH"
### MANAGED BY RANCHER DESKTOP END (DO NOT EDIT)
export PATH="$HOME/.rd/bin:$PATH"
# 変更なし(ここまで)----------------------------------
autoload -Uz add-zsh-hook
_use_homebrew_yarn_outside_projecta() {
local project="/Users/user-name/Documents/project-a"
local nodebrew_bin="$HOME/.nodebrew/current/bin"
local brew_bin="/opt/homebrew/bin"
# 既存のエントリを取り除いてから並べ直す(重複防止)
path=(${path:#$nodebrew_bin})
path=(${path:#$brew_bin})
case "$PWD" in
"$project"|"$project"/*)
# projecta: nodebrew(Corepack / Yarn 4)を優先
path=($nodebrew_bin $brew_bin $path)
;;
*)
# 他プロジェクト: Homebrew の yarn を優先
path=($brew_bin $nodebrew_bin $path)
;;
esac
rehash # zsh が覚えているコマンドの場所をリセットする
}
# ディレクトリ移動時に関数を実行する
add-zsh-hook chpwd _use_homebrew_yarn_outside_projecta
_use_homebrew_yarn_outside_projecta
_use_nodebrew_yarn_in_projecta関数
プロジェクトAのディレクトリにいるときだけ、nodebrewのPATHを優先する仕組み。
優先順位はNodebrew > Homebrew > その他のPATH
プロジェクトA以外ではHomebrew > Nodebrew > その他のPATHとなる。
動作確認
# 現在のPATHの優先順位を確認
echo $PATH