できない.dev

pnpm add「ERR_PNPM_ADDING_TO_ROOT」の原因と直し方

ERR_PNPM_ADDING_TO_ROOT は、ルートに入れるなら -w、パッケージに入れるなら --filter を付ければ直る。
ワークスペースのルートで入れ先を指定せずに pnpm add を打つと出る。

公開: 更新:

症状できない · exit 1
pnpm add is-odd
 ERR_PNPM_ADDING_TO_ROOT  Running this command will add the dependency to the workspace root, which might not be what you want - if you really meant it, make it explicit by running this command again with the -w flag (or --workspace-root). If you don't want to see this warning anymore, you may set the ignore-workspace-root-check setting to true.
解決後できた · exit 0
pnpm add is-odd --filter web
Progress: resolved 1, reused 0, downloaded 0, added 0
Progress: resolved 2, reused 0, downloaded 0, added 0, done
.                                        |   +2 +
Done in 643ms using pnpm v9.15.9

2026-11-13 に node:20(pnpm 9.15.9 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

ワークスペースのルートで pnpm add is-odd を打つと、ERR_PNPM_ADDING_TO_ROOT で止まる。
pnpm 9.15.9 では次のように出て、終了コードは 1 になる。
package.json は書き換わらない。

 ERR_PNPM_ADDING_TO_ROOT  Running this command will add the dependency to the workspace root, which might not be what you want - if you really meant it, make it explicit by running this command again with the -w flag (or --workspace-root). If you don't want to see this warning anymore, you may set the ignore-workspace-root-check setting to true.

pnpm 12.16.1 では、同じ内容が Error: ERR_PNPM_ADDING_TO_ROOT で始まる形で折り返して出る。
ルートに入れるなら -w を付け、パッケージに入れるなら --filter を付ければ直る。

実行例

pnpm 9.15.9 のワークスペースのルートで pnpm add is-odd を打つと、ERR_PNPM_ADDING_TO_ROOT で終了コード 1 になった。
--filter web なら子パッケージに、-w と --ignore-workspace-root-check ならルートに依存が入った。

$ pnpm --version
9.15.9
$ pnpm add is-odd
 ERR_PNPM_ADDING_TO_ROOT  Running this command will add the dependency to the workspace root, which might not be what you want - if you really meant it, make it explicit by running this command again with the -w flag (or --workspace-root). If you don't want to see this warning anymore, you may set the ignore-workspace-root-check setting to true.
$ echo $?
1
$ cat package.json
{ "name": "root", "private": true }
$ pnpm add is-odd --filter web
Progress: resolved 1, reused 0, downloaded 0, added 0
Progress: resolved 2, reused 0, downloaded 0, added 0, done
.                                        |   +2 +
Done in 643ms using pnpm v9.15.9
$ echo $?
0
$ cat packages/web/package.json
{"name":"web","version":"1.0.0","dependencies":{"is-odd":"^3.0.1"}}
$ pnpm add -w is-odd
 WARN  `node_modules` is present. Lockfile only installation will make it out-of-date
Progress: resolved 1, reused 0, downloaded 0, added 0
Progress: resolved 2, reused 0, downloaded 0, added 0, done
 
dependencies:
+ is-odd ^3.0.1
 
Already up to date
Done in 429ms using pnpm v9.15.9
$ echo $?
0
$ cat package.json
{"name":"root","private":true,"dependencies":{"is-odd":"^3.0.1"}}
$ pnpm add is-even --ignore-workspace-root-check
 WARN  `node_modules` is present. Lockfile only installation will make it out-of-date
Progress: resolved 1, reused 0, downloaded 0, added 0
Progress: resolved 7, reused 0, downloaded 0, added 0, done
 
dependencies:
+ is-even ^1.0.0
 
Packages: +5
+++++
Done in 649ms using pnpm v9.15.9
$ echo $?
0

— 2026-11-13 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-11-13 検証(ほか 2 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5
  • pnpm 9.15.9

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 入れ先のパッケージを指定する

pnpm add is-odd --filter web

パッケージのディレクトリへ移動して pnpm add is-odd を打っても入る。
pnpm 12.16.1 の --filter に存在しない名前を渡すと、何も入らないのに Done と出て終了コード 0 で終わった。
入ったかどうかは package.json で確かめる。

2. ルートに入れる

pnpm add -w is-odd

-w は --workspace-root の短い形で、ワークスペース内のどのディレクトリから打ってもルートに入る。
ワークスペースの外で打つと --workspace-root may only be used inside a workspace で止まる。
間違えて入れたものは pnpm remove -w is-odd で外せる。

3. 確認を止める

一度だけなら pnpm add is-odd --ignore-workspace-root-check と打つ。
常に止めるなら設定に書く。

packages:
  - "packages/*"
  - "apps/*"
ignoreWorkspaceRootCheck: true

効く場所は版で違う。
pnpm-workspace.yaml の設定は 10.34.9 と 12.16.1 で効き、9.15.9 では効かなかった。
.npmrc の ignore-workspace-root-check=true は 9.15.9 と 10.34.9 で効き、12.16.1 では効かなかった。

よくある原因

  1. 入れ先のパッケージを指定していない。
    入れたいのは packages/web なのに、ルートのディレクトリで打つと起きる。
    pnpm add -D でも同じように止まる。
  2. ルートに入れたいのに -w を付けていない。
    ワークスペース全体で使う開発ツールを入れるときに起きる。
  3. pnpm の版と packages のパターン数の組み合わせが、エラーの条件に当たっている。
    公式の説明では失敗するとされているが(pnpm add(新しいタブで開く))、実測では 10.5.0 以降の条件が次のように変わっていた。
pnpm の版パターン 1 個(packages/*)パターン 2 個(packages/* と apps/*)
9.15.9・10.4.1エラーエラー
10.5.0・10.34.9・11.28.10・12.16.1エラーなしでルートに入るエラー

パターンが 1 個だと、入れ先を間違えても止まらず、ルートの package.json に書き込まれる。
パターンを足した日から同じコマンドが失敗するようになる。