ツール
pnpm
コンテンツアドレス可能なストアと厳格な node_modules でディスク使用量と再現性を改善する Node.js パッケージマネージャー。npm 互換のコマンドを持ちつつ workspace やハードリンク、peer 依存の扱いで独自の詰まり方をする。
バージョン移行
メジャーバージョンを上げたときに動かなくなることを、旧版と新版で同じコマンドを打ち比べて確かめた。
pnpm 11 → 12・変更点 6 つ
pnpm を 11 から 12 に上げると動かなくなることpnpm 10 → 11・変更点 9 つ
pnpm を 10 から 11 に上げると動かなくなること
問題一覧(7)
pnpm add「ERR_PNPM_ADDING_TO_ROOT」の原因と直し方
ERR_PNPM_ADDING_TO_ROOT は、ルートに入れるなら -w、パッケージに入れるなら --filter を付ければ直る。ワークスペースのルートで入れ先を指定せずに pnpm add を打つと出る。
更新: 2026-11-13、タグ: ERR_PNPM_ADDING_TO_ROOT、workspace、monorepo
pnpm: command not found で pnpm コマンドが実行できない
pnpm: command not found は、未インストールか Corepack 未有効、または PNPM_HOME が PATH に無いのが原因。Corepack を有効化するのが最も手軽で再現性も高い(Node 25 以降は Corepack の別途インストールが必要)。
更新: 2026-10-21、タグ: corepack、path、command-not-found
pnpm「ERR_PNPM_OUTDATED_LOCKFILE」が CI で出る原因と直し方
ERR_PNPM_OUTDATED_LOCKFILE は、ローカルで pnpm install して pnpm-lock.yaml をコミットすれば直る。CI の pnpm は frozen-lockfile で動き、ロックファイルが古いと止まる。
更新: 2026-11-03、タグ: frozen-lockfile、ci、lockfile
pnpm install が「ERR_PNPM_IGNORED_BUILDS」で失敗して依存をインストールできない
ERR_PNPM_IGNORED_BUILDS は、pnpm 11 以降で未承認のビルドスクリプトがあると出る。pnpm approve-builds で許可するか、allowBuilds に書けば直る。
更新: 2026-10-28、タグ: allowBuilds、approve-builds、postinstall
pnpm「Cannot find module」が移行後に出る原因と直し方
pnpm 移行後の Cannot find module は、読み込んでいるパッケージを pnpm add で宣言すれば直る。pnpm の node_modules はフラットではなく、未宣言の依存は解決できないためだ。
更新: 2026-11-03、タグ: node_modules、hoisting、monorepo
pnpm install が「ERR_PNPM_PEER_DEP_ISSUES」で失敗する(peer 依存)
ERR_PNPM_PEER_DEP_ISSUES は、満たされない・競合する peer 依存を pnpm が厳格に扱って install を止めるサイン。バージョンを実際に直すのが本筋で、誤検知は auto-install-peers や peerDependencyRules で個別に対処する。
更新: 2026-10-01、タグ: peer-dependencies、strict-peer-dependencies、auto-install-peers
pnpm「ERR_PNPM_UNRECOGNIZED_WORKSPACE_SETTINGS」の原因と直し方
ERR_PNPM_UNRECOGNIZED_WORKSPACE_SETTINGS は、pnpm-workspace.yaml の設定名の綴りを直すか行を消せば直る。pnpm 12 は、固定した版で動くプロジェクトの知らない設定を警告ではなくエラーにした。
更新: 2026-11-17、タグ: pnpm12、pnpm-workspace、workspace