できない.dev

Yarn の Plug'n'Play でエディタが型を解決できず Cannot find module になる

Yarn PnP でエディタだけ Cannot find module になるときは、yarn dlx @yarnpkg/sdks で SDK を生成すれば直る。
エディタ拡張が PnP のローダを通らないためだ。

公開: 更新:

症状できない · exit 1
node -e "console.log(require('typescript').version)"
…
Error: Cannot find module 'typescript'
Require stack:
- /tmp/tmp.8kzbffWU81/app/[eval]
    at Module._resolveFilename (node:internal/modules/cjs/loader:1207:15)
解決後できた · exit 0
node -e "console.log(require('typescript').version)"
5.6.3

2026-10-16 に node:20(Yarn 4.9.4 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

yarn install は成功しているのにエディタだけが Cannot find module 'react' と言う場合、原因は依存の欠落ではなく Plug'n'Play(PnP)にエディタが対応していないことだ。
PnP は node_modules を作らず、Node.js のローダを差し込んで解決する。
エディタ拡張はそのローダを通さずに TypeScript や Prettier を直接起動するため、解決できない。

Yarn 公式が用意している SDK を生成すれば解消する。

yarn dlx @yarnpkg/sdks vscode

生成された .yarn/sdks はリポジトリにコミットする。

実行例

Yarn 4.9.4 の Plug'n'Play で typescript を入れたプロジェクトでは node_modules が作られず、Yarn のローダを通さない素の node は Cannot find module 'typescript' で止まった。
yarn sdks vscode で .yarn/sdks と .vscode/settings.json を生成すると yarn node や yarn tsc からは 5.6.3 が見え、nodeLinker: node-modules に切り替えて yarn install し直すと素の node でも解決している。

$ yarn --version
4.9.4
$ ls -A
.pnp.cjs
.yarn
package.json
yarn.lock
$ node -e "console.log(require('typescript').version)"
node:internal/modules/cjs/loader:1210
  throw err;
  ^
 
Error: Cannot find module 'typescript'
Require stack:
- /tmp/tmp.8kzbffWU81/app/[eval]
    at Module._resolveFilename (node:internal/modules/cjs/loader:1207:15)
    at Module._load (node:internal/modules/cjs/loader:1038:27)
    at Module.require (node:internal/modules/cjs/loader:1289:19)
    at require (node:internal/modules/helpers:182:18)
    at [eval]:1:13
    at runScriptInThisContext (node:internal/vm:209:10)
    at node:internal/process/execution:118:14
    at [eval]-wrapper:6:24
    at runScript (node:internal/process/execution:101:62)
    at evalScript (node:internal/process/execution:133:3) {
  code: 'MODULE_NOT_FOUND',
  requireStack: [ '/tmp/tmp.8kzbffWU81/app/[eval]' ]
}
 
Node.js v20.20.2
$ echo $?
1
$ cat package.json
{
  "name": "pnp-demo",
  "version": "1.0.0",
  "packageManager": "yarn@4.9.4",
  "dependencies": {
    "typescript": "5.6.3"
  },
  "resolutions": {
    "@yarnpkg/core": "4.9.1"
  }
}
$ yarn add -D @yarnpkg/sdks
➤ YN0000: · Yarn 4.9.4
➤ YN0000: ┌ Resolution step
➤ YN0085: │ + @yarnpkg/sdks@npm:3.3.1, @arcanis/slice-ansi@npm:1.1.1, @isaacs/fs-minipass@npm:4.0.1, @nodelib/fs.scandir@npm:2.1.5, @nodelib/fs.stat@npm:2.0.5, and 96 more.
➤ YN0000: └ Completed in 0s 915ms
➤ YN0000: ┌ Fetch step
➤ YN0013: │ 101 packages were added to the project (+ 16.38 MiB).
➤ YN0000: └ Completed in 0s 693ms
➤ YN0000: ┌ Link step
➤ YN0000: │ ESM support for PnP uses the experimental loader API and is therefore experimental
➤ YN0000: └ Completed
➤ YN0000: · Done with warnings in 1s 675ms
$ echo $?
0
$ yarn sdks vscode
➤ YN0000: ┌ Generating SDKs inside .yarn/sdks
➤ YN0000: │ ✓ Typescript
➤ YN0000: │ • 10 SDKs were skipped based on your root dependencies
➤ YN0000: └ Completed
➤ YN0000: ┌ Generating settings
➤ YN0000: │ ✓ Vscode (new ✨)
➤ YN0000: └ Completed
$ echo $?
0
$ ls .yarn/sdks
integrations.yml
typescript
$ cat .vscode/settings.json
{
  "search.exclude": {
    "**/.yarn": true,
    "**/.pnp.*": true
  },
  "typescript.tsdk": ".yarn/sdks/typescript/lib",
  "typescript.enablePromptUseWorkspaceTsdk": true
}
$ yarn node -e "console.log(require('typescript').version)"
5.6.3
$ echo $?
0
$ yarn tsc --version
Version 5.6.3
$ echo $?
0
$ yarn install
➤ YN0000: · Yarn 4.9.4
➤ YN0000: ┌ Resolution step
➤ YN0000: └ Completed
➤ YN0000: ┌ Fetch step
➤ YN0000: └ Completed
➤ YN0000: ┌ Link step
➤ YN0000: └ Completed in 1s 20ms
➤ YN0000: · Done in 1s 168ms
$ echo $?
0
$ ls -A
.vscode
.yarn
.yarnrc.yml
node_modules
package.json
yarn.lock
$ node -e "console.log(require('typescript').version)"
5.6.3
$ echo $?
0

— 2026-10-16 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-16 検証(ほか 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
  • Yarn 4.9.4

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

解決策

1. エディタ SDK を生成する

使っているエディタを指定して実行する。
複数指定もできる。

yarn dlx @yarnpkg/sdks vscode
yarn dlx @yarnpkg/sdks vim
yarn dlx @yarnpkg/sdks base   # 特定エディタ向け設定なしで SDK だけ入れる

yarn dlx @yarnpkg/sdks が Resolution step で got@patch:got@npm%3A11.8.2#~/.yarn/patches/…: ENOENT になって止まることがある。
これは、SDK の依存の @yarnpkg/core 4.9.2(2026-09-24 公開)が got を手元のパッチファイル指定のまま公開しているためである。
@yarnpkg/sdks のどの版でも同じになる(2026-10-05 時点・Yarn 4.18.1)。
直るまでは package.json の resolutions で @yarnpkg/core を 4.9.1 に固定し、SDK を開発依存として入れて実行すれば生成できる。

"resolutions": {
  "@yarnpkg/core": "4.9.1"
}
yarn add -D @yarnpkg/sdks
yarn sdks vscode

VS Code を指定すると .vscode/settings.json の typescript.tsdk も併せて設定される。
生成物はコミットして、チーム全員が同じ状態になるようにする。

2. ワークスペース版 TypeScript に切り替える

VS Code ではコマンドパレット(Ctrl+Shift+P / Cmd+Shift+P)で TypeScript: Select TypeScript Version を開き、Use Workspace Version を選ぶ。
ここを切り替えないと、SDK を入れても同梱版が使われ続ける。

3. コマンドラインでも yarn 経由で実行する

ターミナルから直接叩く場合も、ローダを通す必要がある。

yarn node script.js     # node script.js ではなく
yarn tsc --noEmit       # package.json の scripts 経由でも同じ

yarn を前置きすると PnP のローダが有効な状態で子プロセスが起動する。

4. どうしても合わないなら node_modules に戻す

対応していないツールが多く、当面 PnP を諦める判断もありうる。
.yarnrc.yml にリンカを指定する。

nodeLinker: node-modules

この設定では従来どおり node_modules が作られる。
PnP の起動速度や厳密さは失われるので、ツール側の対応状況を見て戻す前提で使う。

よくある原因

  1. エディタ拡張が node_modules を前提に探索している。
    多くのエディタ拡張は node_modules 直下からツール本体を探すが、PnP では実体がそこに無い。
  2. ツールがローダを通らずに起動している。
    拡張が包んでいる TypeScript や Prettier を素の Node.js で起動しており、PnP のローダが注入されない。
    公式ドキュメント(新しいタブで開く)は、この問題を回避するために SDK が「中継用パッケージ」を生成すると説明している。
  3. SDK を生成していないか、コミットしていない。
    自分の環境では動いていても、SDK をコミットしていなければ他の開発者や CI で同じ症状が再発する。
  4. ワークスペース版 TypeScript が選ばれていない。
    SDK を入れても、VS Code が同梱版の TypeScript を使っていると効果が出ない。