yarn: command not found で yarn コマンドが実行できない

要約

yarn: command not found（zsh: command not found: yarn など）は、yarn の実行ファイルが PATH 上に無いときに出る。

近年の推奨は、Corepack を有効化して yarn を使えるようにする方法。
Corepack は Node 24 までは同梱されているが、Node 25 以降は同梱されなくなったので別途入れる。
Corepack が使えない環境では npm でのグローバル導入でもよい。

実行例

node:20 のイメージに同梱された yarn のシムを先に外し（この操作は出力に含めていない）、PATH に yarn が無い状態から始めている。yarn --version は bash の command not found で終了コード 127 になったが、corepack enable のあとは同じコマンドが Corepack 経由で 1.22.22 を取得して表示し、シムは /usr/local/bin/yarn に置かれた。

$ node -v
v20.20.2

$ yarn --version
bash: line 1: yarn: command not found
$ echo $?
127

$ corepack enable
$ echo $?
0

$ yarn --version
! Corepack is about to download https://registry.yarnpkg.com/yarn/-/yarn-1.22.22.tgz
1.22.22
$ echo $?
0

$ which yarn
/usr/local/bin/yarn

$ npm config get prefix
/usr/local

— 2026-09-30 時点の出力

解決策

1. Corepack を有効化する

corepack enable
yarn --version

Corepack は Node 24 までの Node に同梱され、enable で yarn / pnpm のシムを PATH 上に用意する（Node 25 以降は次の手順 2 で先に入れる）。

2. Corepack が無い場合

npm install -g corepack
corepack enable

corepack: command not found になるなら、先に corepack 自体を入れる。

3. npm でグローバル導入する

npm install -g yarn

Corepack を使わない運用なら、これで手早く yarn を入れられる。

4. PATH を確認する

npm config get prefix

表示されたディレクトリ配下の bin が PATH に含まれているかを確認する。

よくある原因

1. Corepack 無効: yarn のシムを用意する Corepack を有効化していない。
2. Corepack 非同梱: Node 25 以降は公式の配布物にも Corepack が含まれない。
   ディストリのパッケージで入れた Node にも含まれない/無効なことがある。
3. 未インストール: そもそも yarn を入れていない。
4. PATH 未設定: グローバル bin にパスが通っていない。