0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【yarn】バージョン指定 homebrew VS nodebrew どちらかを優先したい場合

0
Last updated at Posted at 2026-11-19

目次

はじめに

参画したプロジェクト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
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?