MeWrite Docs

pnpm: Peer dependency issues

pnpmでpeer dependencyの警告やエラーが発生した場合の解決策

概要

pnpmでパッケージのpeer dependencyが解決できない場合の警告やエラーです。

エラーメッセージ

``` WARN Issues with peer dependencies found . └─┬ some-package └── ✕ missing peer react@^18.0.0 ```

原因

  1. peer dependencyの未インストール: 必要なパッケージがない
  2. バージョンの不一致: 要求バージョンと異なる
  3. strict-peer-dependencies設定: 厳格モードでエラー
  4. auto-install-peers無効: 自動インストールが無効

解決策

1. 自動インストールを有効化

```ini

.npmrc

auto-install-peers=true ```

2. peer dependencyを手動インストール

```bash pnpm add react@^18.0.0 react-dom@^18.0.0 ```

3. strict-peer-dependenciesを無効化

```ini

.npmrc

strict-peer-dependencies=false ```

4. pnpm.overridesで強制指定

```json { “pnpm”: { “overrides”: { “react”: “^18.2.0” }, “peerDependencyRules”: { “ignoreMissing”: [“react”, “react-dom”], “allowedVersions”: { “react”: “18” } } } } ```

5. 特定パッケージのpeerを無視

```json { “pnpm”: { “peerDependencyRules”: { “allowAny”: [“react”] } } } ```

よくある間違い

  • npmとpnpmの設定を混同
  • node_modulesを削除せずに設定変更
  • .npmrc の配置場所

関連エラー

関連エラー

Node.js の他のエラー

最終更新: 2025-12-11