pnpm を 11 から 12 に上げると動かなくなること
pnpm を 11 から 12 に上げると、--frozen-lockfile false のように値を離して書いたフラグと --resolution-only が通らなくなり、版を固定したプロジェクトは pnpm-workspace.yaml の知らない設定で止まる。
pnpm add npm は依存に足さずにパッケージマネージャーとして書く。
11.28 と 12.18 で打ち比べた 6 つの変更点と直し方をまとめる。
公開:
npm で pnpm@11 と pnpm@12 を別の場所に入れ、同じファイルを置いたプロジェクトで同じコマンドを打ち比べた。
各節の出力は「v11 では」「v12 に上げると」「v12 で直すと」の 3 段で並ぶ。package.json は手で書き、packageManager で版を固定したのは 3 つ目と 4 つ目の節だけである。
ほかの節では、どちらの pnpm も別の版に切り替わらずにそのまま動いている。
12 は pnpm を Rust で書き直した版である。
公式の移行ガイドによると、12 は 11 と同じ pnpm-lock.yaml・pnpm-workspace.yaml・ストアを読み、Node.js が無くても動くネイティブの実行ファイルになった。
実行例でも、12 は 11 と同じ store/v11 を使っている。
11 から 12 への codemod は無い。
packageManager で 11 を固定したプロジェクトでは、12 を入れても 11 が動く(3 つ目の節)。
移行ガイドの手順では、ワークスペースのルートで pnpm self-update 12 を打ち、固定した版も 12 に書き換える。
10 から 11 への移行ページの最後の節では、11.28.11 の pnpm init が 12.18.0 を固定し、そのディレクトリの pnpm --version は 12.18.0 を返していた。
そうして作ったプロジェクトは、手元の pnpm が 11 でも既に 12 で動いている。
動かなくなる原因は 3 つに分かれる。
1 つ目はコマンドラインで、値を離して書いた真偽値のフラグと --resolution-only が通らない。
2 つ目は pnpm-workspace.yaml の検査で、版を固定したプロジェクトは知らない設定と 11 の confirmModulesPurge で止まる。
3 つ目は書き方の意味の変化で、pnpm add npm はパッケージマネージャーの指定を書き、shellEmulator の変数の展開も変わった。
12.1.0 のリリースノートによると、12.0.0 は --shamefully-hoist や --no-lockfile などの設定のフラグを拒んでいて、12.1.0 で受け付けるようになった。
12.3.4 のリリースノートによると、--unsafe-perm などの真偽値の設定のフラグも、それより前の 12 では unexpected argument で拒まれていた。
12 に上げるときは 12.3.4 以降にする。
このページの実行例は 12.18.0 で打っている。
次の変更は、このページでは打っていない。
- GitHub・GitLab・Bitbucket の Git の依存は、どの書き方でもホストの HTTPS の URL で解決され、ロックファイルに SSH の URL が書かれなくなった。
私的なリポジトリを SSH で取るなら、マシンの git にurl."git@github.com:".insteadOfを設定する。
11 が書いた SSH の行は、pnpm update <パッケージ名>で解決し直すまで残る。 engineStrictのとき、optionalDependenciesの下にあっても、通常の依存の先に engines の合わないパッケージがあると install が失敗する。- pnpm で入れたグローバルの
node・deno・bunは、プロジェクトがdevEngines.runtimeや.nvmrcで固定した版で動くようになった。
止めるにはglobalShims: falseを書く。pnpm add -g yarnが入れるのも、Yarn Classic から今の Yarn の系列に替わった。 sudoを付けたpnpm setup・pnpm self-update・グローバルへの install は、ERR_PNPM_SUDO_NOT_SUPPORTEDで止まる。- pnpmfile の
importPackageは呼ばれなくなり、filterLogは警告を出して無視される。scriptsPrependNodePathも無視され、スクリプトはPATHにあるnodeで走る。 - レジストリへの TLS は OS の証明書ストアを使い、
maxsocketsの既定値の 50 が無くなった。 - Linux の
packageImportMethod: autoは、クローンより先にハードリンクを試す。
btrfs などでnode_modulesのファイルを書き換えるならcloneを書く。 - 循環する依存の切り方が決まった位置になり、解決し直す最初の install でロックファイルに一度だけ差分が出る。
shellEmulatorのシェルが解析できないスクリプトは、ERR_PNPM_EXECUTOR_SHELL_EMULATOR_PARSEで失敗する。pnpm dlxとpnxは global virtual store を使わず、キャッシュごとに別の virtual store を持つ。pnpm pack-appは、--runtimeもpnpm.app.runtimeも無ければ Node.js 25.5.0 を埋め込む。
11 は pnpm を動かしていた Node.js を埋め込んでいた。--frozen-storeに Node.js の版の条件が無くなり、ERR_PNPM_FROZEN_STORE_UNSUPPORTED_NODEは出なくなった。
ほかの変更も含めた一覧は、移行ガイド(新しいタブで開く)と 12.0.0 のリリースノート(新しいタブで開く) にある。
pnpm install --frozen-lockfile false が通らなくなった
pnpm install のドキュメントによると、CI ではロックファイルがあれば --frozen-lockfile が既定で有効になる。
それを切るために、CI の設定に --frozen-lockfile false と書いているリポジトリがある。
11 はフラグの後ろの false をフラグの値として読んでいた。
移行ガイドによると、12 は真偽値のフラグの値を空白で区切った次の引数として受け取らない。
ここでは --prod false も打ち比べた。
v11 では
$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 2, reused 0, downloaded 2, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 901ms using pnpm v11.28.11
$ echo $?
0$ pnpm install --frozen-lockfile false
Already up to date
Done in 339ms using pnpm v11.28.11
$ echo $?
0$ pnpm install --prod false
Already up to date
Done in 279ms using pnpm v11.28.11
$ echo $?
0$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"is-odd": "3.0.1"
}
}v12 に上げると
$ pnpm install
Progress: resolved 0, reused 1, downloaded 0, added 0
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Packages: +2
++
Progress: resolved 2, reused 2, downloaded 0, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 26ms using pnpm v12.18.0
$ echo $?
0$ pnpm install --frozen-lockfile false
error: unexpected argument '--frozen-lockfile' found
tip: to pass '--frozen-lockfile' as a value, use '-- --frozen-lockfile'
Usage: pnpm add [OPTIONS] <PACKAGE_NAMES>...
For more information, try '--help'.
$ echo $?
2$ pnpm install --prod false
✓ Lockfile passes supply-chain policies (verified 250ms ago)
Packages: +1
+
Progress: resolved 1, reused 0, downloaded 1, added 1, done
dependencies:
+ false 0.0.4
Done in 345ms using pnpm v12.18.0
$ echo $?
0$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"false": "^0.0.4",
"is-odd": "3.0.1"
}
}v12 で直すと
$ pnpm remove false
✓ Lockfile passes supply-chain policies (verified 35ms ago)
Lockfile is up to date, resolution step is skipped
Packages: -1
-
dependencies:
- false 0.0.4
Done in 19ms using pnpm v12.18.0
$ echo $?
0$ pnpm install --no-frozen-lockfile
Already up to date
Done in 1ms using pnpm v12.18.0
$ echo $?
0$ pnpm install --frozen-lockfile=false
Already up to date
Done in 1ms using pnpm v12.18.0
$ echo $?
0$ pnpm install --prod=false
Already up to date
Done in 1ms using pnpm v12.18.0
$ echo $?
0$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"is-odd": "3.0.1"
}
}12 は --frozen-lockfile false を unexpected argument で拒み、終了コード 2 を返した。Usage の行は pnpm add になっている。
12 はこのコマンドを pnpm add として読み、--frozen-lockfile はそのオプションに無いので拒まれた。
次の --prod false の結果のとおり、後ろの false は入れるパッケージの名前として読まれる。
--prod false はエラーにならなかった。
12 は false という名前の npm のパッケージ(0.0.4)を入れ、package.json の dependencies に "false": "^0.0.4" を足して 0 を返した。
移行ガイドは --prod false も拒まれると書いているが、12.18.0 では通る。
足されたパッケージは pnpm remove false で消える。
値は = でつなぐか、--no- を付けた形で書く。--no-frozen-lockfile・--frozen-lockfile=false・--prod=false は、どれも 12 で通った。
pnpm install --resolution-only が無くなった
--resolution-only は、依存を入れずに解決だけを行うフラグである。
11 では node_modules を作らずにロックファイルを書き、peer 依存の問題があれば 1 行の警告を出していた。
What's different in pnpm 12 によると、12 はこのフラグを実装していない。
ここでは react 19 と、react 18 までを求める react-redux 8 を並べた。
v11 では
$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"react": "19.2.0",
"react-redux": "8.1.3"
}
}$ pnpm install --resolution-only
Progress: resolved 1, reused 0, downloaded 0, added 0
Progress: resolved 12, reused 0, downloaded 0, added 0, done
[WARN] Issues with peer dependencies found. Run "pnpm peers check" to list them.
Done in 1.2s using pnpm v11.28.11
$ echo $?
0$ ls
package.json
pnpm-lock.yamlv12 に上げると
$ pnpm install --resolution-only
error: unexpected argument '--resolution-only' found
tip: a similar argument exists: '--production'
Usage: pnpm install --prod
For more information, try '--help'.
$ echo $?
2v12 で直すと
$ pnpm peers check
No peer dependency issues found
$ echo $?
0$ pnpm install --lockfile-only
[WARN] Issues with peer dependencies found. Run "pnpm peers check" to list them.
Done in 39ms using pnpm v12.18.0
$ echo $?
0$ ls
package.json
pnpm-lock.yaml$ pnpm peers check
Issues with peer dependencies found
✕ unmet peer @types/react
Installed: 19.3.0
Wanted:
"^16.8 || ^17.0 || ^18.0":
react-redux@8.1.3
✕ unmet peer react
Installed: 19.2.0
Wanted:
"^16.8 || ^17.0 || ^18.0":
react-redux@8.1.3
$ echo $?
112 は unexpected argument で止まり、終了コード 2 を返した。
エラー文の tip は --production を挙げている。
ドキュメントによると --prod は devDependencies を入れないフラグで、解決だけを行う代わりにはならない。
What's different in pnpm 12 は、代わりに pnpm peers check を挙げている。
このコマンドはロックファイルから問題を読む。
ロックファイルの無いディレクトリで打つと、問題があるのに No peer dependency issues found を出して 0 を返した。pnpm install --lockfile-only でロックファイルを書いてから打つと、react-redux の求める範囲に合わない react を挙げ、終了コード 1 を返した。
CI で pnpm install --resolution-only を打っていたなら、pnpm install --lockfile-only と pnpm peers check の 2 行に置き換える。
公式の説明では、pnpm peers check はロックファイルから読むので解決し直しも install も要らない。
コミットしたロックファイルがあるリポジトリなら、pnpm peers check だけでよい。
pnpm-workspace.yaml の知らない設定で install が止まるようになった
12.0.0 のリリースノートによると、12 は pnpm-workspace.yaml の知らない設定の扱いを、版の固定で分ける。
プロジェクトが固定した版を動いている pnpm が満たすときはエラーにし、そうでなければ警告だけを出す。
ここでは minimumReleaseAge を minimumReleaseAg と打ち間違え、11.28.11 に固定したプロジェクトで打った。
v11 では
$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"packageManager": "pnpm@11.28.11",
"dependencies": {
"is-odd": "3.0.1"
}
}$ cat pnpm-workspace.yaml
minimumReleaseAg: 0$ pnpm install
[WARN] The following settings in pnpm-workspace.yaml are not recognized by this version of pnpm and were ignored: "minimumReleaseAg" (did you mean "minimumReleaseAge"?).
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 2, reused 2, downloaded 0, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 421ms using pnpm v11.28.11
$ echo $?
0v12 に上げると
$ pnpm --version
[WARN] The following settings in pnpm-workspace.yaml are not recognized by this version of pnpm and were ignored: "minimumReleaseAg" (did you mean "minimumReleaseAge"?).
11.28.11$ pnpm install
[WARN] The following settings in pnpm-workspace.yaml are not recognized by this version of pnpm and were ignored: "minimumReleaseAg" (did you mean "minimumReleaseAge"?).
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 2, reused 2, downloaded 0, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 167ms using pnpm v11.28.11
$ echo $?
0$ pnpm self-update 12
Checking for updates...
Switching pnpm from v12.18.0 to v12.18.0...
.../global/v11/2f0-18e7759aec1c9460-0 | Progress: resolved 1, reused 0, downloaded 0, added 0
Downloading @pnpm/exe.linux-x64@12.18.0: 0.00 B/26.64 MB
Packages are copied from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: ../../../root/.local/share/pnpm/global/v11/2f0-18e7759aec1c9460-0/node_modules/.pnpm
Downloading @pnpm/exe.linux-x64@12.18.0: 26.64 MB/26.64 MB, done
.../global/v11/2f0-18e7759aec1c9460-0 | Progress: resolved 2, reused 0, downloaded 2, added 2, done
The current project has been updated to use pnpm v12.18.0
Successfully updated pnpm to v12.18.0
$ echo $?
0$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"packageManager": "pnpm@12.18.0",
"dependencies": {
"is-odd": "3.0.1"
}
}$ pnpm --version
12.18.0$ pnpm install
Error: ERR_PNPM_UNRECOGNIZED_WORKSPACE_SETTINGS
× The following settings in pnpm-workspace.yaml are not recognized by this
│ version of pnpm: "minimumReleaseAg" (did you mean "minimumReleaseAge"?).
help: The project pins pnpm to a version the running pnpm satisfies, so
these settings cannot be meant for a different pnpm version. Remove
them from pnpm-workspace.yaml or fix their spelling.
$ echo $?
1v12 で直すと
$ cat pnpm-workspace.yaml
minimumReleaseAge: 0$ pnpm install
✓ Lockfile passes supply-chain policies (verified 10s ago)
Lockfile is up to date, resolution step is skipped
Done in 9ms using pnpm v12.18.0
$ echo $?
0$ pnpm config get minimumReleaseAge
011 は打ち間違いを警告して近い名前を挙げ、install は 0 で終わった。
設定は効いていない。
12.0.0 のリリースノートは、以前の pnpm がこうした設定を黙って無視していたと書いているが、11.28.11 は警告を出している。
12 を入れても、11 に固定したプロジェクトでは pnpm --version が 11.28.11 を返し、install も 11 で走った。
移行ガイドの手順どおり pnpm self-update 12 を打つと、packageManager が pnpm@12.18.0 に書き換わった。
12 が固定を満たすようになると、同じ打ち間違いで ERR_PNPM_UNRECOGNIZED_WORKSPACE_SETTINGS が出て、終了コード 1 で止まった。
綴りを直すと install は通り、pnpm config get minimumReleaseAge は 0 を返した。
リリースノートによると、pnpm config のサブコマンドはこの検査で失敗しないので、止まったプロジェクトでも設定の値を確かめられる。
11 の警告に出た打ち間違いは、固定を 12 に替えると止まる。
12 に上げる前に、11 の install の警告を読んで綴りを直しておく。
ただし次の節の confirmModulesPurge のように、11 が知っていて 12 が知らない設定は、11 では警告に出ない。
confirmModulesPurge が無くなった
confirmModulesPurge は、設定を変えて node_modules を作り直すときに確認を求めるかを決める 11 の設定である。
10 から 11 への移行ページでは、端末の無いところで作り直しが ERR_PNPM_ABORTED_REMOVE_MODULES_DIR_NO_TTY で止まり、エラー文がこの設定を false にするよう案内していた。
移行ガイドによると、12 はこの設定を拒む。
v11 では
$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"is-odd": "3.0.1"
},
"packageManager": "pnpm@11.28.11"
}$ cat pnpm-workspace.yaml
confirmModulesPurge: false$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 2, reused 2, downloaded 0, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 397ms using pnpm v11.28.11
$ echo $?
0$ cat pnpm-workspace.yaml
confirmModulesPurge: false
shamefullyHoist: true$ pnpm install
Recreating /work/v11/confirm-modules-purge/node_modules
✓ Lockfile passes supply-chain policies (verified 357ms ago)
Lockfile is up to date, resolution step is skipped
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2
++
Progress: resolved 2, reused 2, downloaded 0, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 398ms using pnpm v11.28.11
$ echo $?
0$ ls node_modules
is-number
is-oddv12 に上げると
$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"dependencies": {
"is-odd": "3.0.1"
},
"packageManager": "pnpm@12.18.0"
}$ pnpm install
Error: ERR_PNPM_UNRECOGNIZED_WORKSPACE_SETTINGS
× The following settings in pnpm-workspace.yaml are not recognized by this
│ version of pnpm: "confirmModulesPurge" (a pnpm v11 setting).
help: The project pins pnpm to a version the running pnpm satisfies, so
these settings cannot be meant for a different pnpm version. Remove
them from pnpm-workspace.yaml or fix their spelling.
$ echo $?
1v12 で直すと
$ rm pnpm-workspace.yaml$ pnpm install
Progress: resolved 0, reused 1, downloaded 0, added 0
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Packages: +2
++
Progress: resolved 2, reused 2, downloaded 0, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 18ms using pnpm v12.18.0
$ echo $?
0$ ls node_modules
is-odd$ cat pnpm-workspace.yaml
shamefullyHoist: true$ pnpm install
✓ Lockfile passes supply-chain policies (verified 34ms ago)
Lockfile is up to date, resolution step is skipped
Packages: +2
++
Progress: resolved 2, reused 2, downloaded 0, added 2, done
dependencies:
+ is-odd 3.0.1
Done in 16ms using pnpm v12.18.0
$ echo $?
0$ ls node_modules
is-number
is-odd11 は shamefullyHoist を足した 2 回目の install で、確認を求めずに node_modules を作り直した(Recreating の行)。is-number が node_modules の直下に出ている。
12 に固定したプロジェクトでは、同じ pnpm-workspace.yaml が ERR_PNPM_UNRECOGNIZED_WORKSPACE_SETTINGS で止まった。
エラー文は confirmModulesPurge を a pnpm v11 setting と書いている。
confirmModulesPurge の行を消すと、install は通った。
続けて shamefullyHoist: true を書くと、12 は端末の無いコンテナでも止まらずに入れ直し、is-number が直下に出た。
12.18.0 は、この場面で確認を求めなかった。
12 では confirmModulesPurge の行を消すだけでよい。
pnpm add npm がパッケージマネージャーの指定を書くようになった
12 は npm・Yarn・Bun を自分で入れられるようになった。
そのため pnpm add に渡したこれらの名前は道具を指し、プロジェクトが使うパッケージマネージャーとして package.json に書かれる。
ここでは npm 10 を開発用の依存に入れたプロジェクトで、npm を 11 に上げようとして pnpm add -D npm@11 を打った。
v11 では
$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"devDependencies": {
"npm": "10.9.10"
}
}$ pnpm install
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +1
+
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 1, reused 0, downloaded 1, added 1, done
devDependencies:
+ npm 10.9.10 (12.2.2 is available)
Done in 1.2s using pnpm v11.28.11
$ echo $?
0$ pnpm add -D npm@11
✓ Lockfile passes supply-chain policies (verified 401ms ago)
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +1 -1
+-
Progress: resolved 1, reused 0, downloaded 1, added 1, done
devDependencies:
- npm 10.9.10
+ npm 11.21.2 (12.2.2 is available)
Done in 1.2s using pnpm v11.28.11
$ echo $?
0$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"devDependencies": {
"npm": "^11.21.2"
}
}$ pnpm exec npm --version
11.21.2v12 に上げると
$ pnpm install
Progress: resolved 0, reused 1, downloaded 0, added 0
Packages are hard linked from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Packages: +1
+
Progress: resolved 1, reused 1, downloaded 0, added 1, done
devDependencies:
+ npm 10.9.10
Done in 87ms using pnpm v12.18.0
$ echo $?
0$ pnpm add -D npm@11
Recorded npm@11 as the project's package manager
Done in 10ms using pnpm v12.18.0
$ echo $?
0$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"devDependencies": {
"npm": "10.9.10"
},
"devEngines": {
"packageManager": {
"name": "npm",
"version": "11"
}
}
}$ pnpm install
Error: ERR_PNPM_OTHER_PM_EXPECTED
× This project is configured to use npm
help: Run a one-off command with "pnpm dlx npm <command>", or link a npm
command that follows this project's pin with "pnpm shim add npm".
$ echo $?
1$ pnpm exec npm --version
Error: ERR_PNPM_OTHER_PM_EXPECTED
× This project is configured to use npm
help: Run a one-off command with "pnpm dlx npm <command>", or link a npm
command that follows this project's pin with "pnpm shim add npm".
$ echo $?
1v12 で直すと
$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"devDependencies": {
"npm": "10.9.10"
}
}$ pnpm add -D npm@npm:npm@11
✓ Lockfile passes supply-chain policies (verified 67ms ago)
Packages: +1 -1
+-
Progress: resolved 1, reused 1, downloaded 0, added 1, done
devDependencies:
- npm 10.9.10
+ npm 11.21.2
Done in 199ms using pnpm v12.18.0
$ echo $?
0$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"devDependencies": {
"npm": "npm:npm@^11.21.2"
}
}$ pnpm exec npm --version
11.21.211 は devDependencies の npm を 11.21.2 に上げた。
12 も、既に devDependencies にある npm は pnpm install でそのまま入れた。
ところが pnpm add -D npm@11 は Recorded npm@11 as the project's package manager と出して 0 を返し、devEngines.packageManager に npm 11 を書いた。devDependencies の npm は 10.9.10 のまま残っている。
これ以降、このプロジェクトでは pnpm install も pnpm exec も ERR_PNPM_OTHER_PM_EXPECTED で止まる。
12 は、このプロジェクトを npm で管理するものとして読んでいる。
直すには、書かれた devEngines を消し、npm: を付けて npm のパッケージだと明示して入れる。pnpm add -D npm@npm:npm@11 は devDependencies に npm:npm@^11.21.2 と書き、pnpm exec npm --version は 11.21.2 を返した。
Other package managers のページによると、pnpm add yarn@4 は packageManager に yarn@4.18.0 のような厳密な版を書く。
Yarn の npm のパッケージが要るなら、pnpm add yarn@npm:yarn@1.22.22 と書く。pnpm add bun も、Bun をパッケージマネージャーとして書く。
shellEmulator で、スクリプトの中で代入した変数が既定値の展開に効かなくなった
ドキュメントによると、shellEmulator: true は package.json のスクリプトを pnpm の持つ bash に似たシェルで走らせる設定で、Windows でも NODE_ENV=test node test.js のような書き方が通る。
移行ガイドによると、12 はこのシェルを @yarnpkg/shell から pnpm 自身のものに替えた。${NAME:-word} と ${NAME:+word} は、スクリプトを始めたときの環境の NAME を読み、同じスクリプトの前のほうでの代入を読まない。
v11 では
$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"scripts": {
"build": "MODE=production && echo mode=${MODE:-development}"
}
}$ cat pnpm-workspace.yaml
shellEmulator: true$ pnpm run build
$ MODE=production && echo mode=${MODE:-development}
mode=production
$ echo $?
0v12 に上げると
$ pnpm run build
$ MODE=production && echo mode=${MODE:-development}
mode=development
$ echo $?
0v12 で直すと
$ cat package.json
{
"name": "app",
"version": "1.0.0",
"private": true,
"scripts": {
"build": "echo mode=${MODE:-development}"
}
}$ pnpm run build
$ echo mode=${MODE:-development}
mode=development
$ echo $?
0$ MODE=production pnpm run build
$ echo mode=${MODE:-development}
mode=production
$ echo $?
011 は MODE=production の代入を読んで mode=production を出し、12 は mode=development を出した。
どちらも終了コードは 0 で、12 は代入を読まなかったことを知らせない。
既定値つきの展開に渡す値は、スクリプトを始めるときの環境変数で渡す。${MODE:-development} だけを残したスクリプトは、何も渡さなければ mode=development を出し、MODE=production pnpm run build で打つと mode=production を出した。
移行ガイドによると、${NAME:=word}・${NAME=word}・${#NAME} は展開されず、書いたままの文字でコマンドに渡る。
検証環境Node.js 24.22.3 / npm 11.19.1 / Python 3.11.2 / 2026-11-13 検証(ほか 3 件)
- 検証日
- 実行環境
node:24Debian GNU/Linux 12 (bookworm)- バージョン
- Node.js 24.22.3
- npm 11.19.1
- Python 3.11.2
- Git 2.39.5
- pnpm(旧) 11.28.11
- pnpm(新) 12.18.0
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。