Kumatora の技術ブログ

Turborepo のドキュメントで、prisma を package 化するときに .npmrc に以下の行の追加が必要という記載がある。

public-hoist-pattern[]=*prisma*

Prisma | Turborepo

Learn how to use Prisma in a Turborepo.

https://turbo.build

実際、これを追加しないと Cannot find module と怒られてしまう。

これはなぜ必要なのか、理解ができていなかったので調べてみた。

これを理解するためには pnpm workspace の仕組みを理解することが必要。

pnpm は node_modules において、ネスト構造を採用している。

• package.json の dependencies に記載されたパッケージ（foo）は、node_modules 配下にディレクトリが作成される
  • このディレクトリは シンボリックリンクになっており、 node_modules/.pnpm に実体がある
• foo が依存している bar は、 node_modules/.pnpm/foo@1.0.0/node_modules 配下にディレクトリが作成される
  • このディレクトリも node_modules/foo 同様、シンボリックリンクになっており、 node_modules/.pnpm に実体がある

node_modules
├── foo -> ./.pnpm/foo@1.0.0/node_modules/foo
└── .pnpm
    ├── bar@1.0.0
    │   └── node_modules
    │       └── bar -> <store>/bar
    └── foo@1.0.0
        └── node_modules
            ├── foo -> <store>/foo
            └── bar -> ../../bar@1.0.0/node_modules/bar

引用： シンボリックリンクを使用した `node_modules` の構造

npm（v3以降） や yarn では、全て node_modules 直下にディレクトリが作成されるため、dependencies に記載されていない依存パッケージも読み込めてしまう。という問題がある。

pnpm の採用しているネスト構造は、この問題を解決するものとなっている。

pnpmのメリット | pnpm

ディスク容量の節約

https://pnpm.io

シンボリックリンクを使用した `node_modules` の構造 | pnpm

This article only describes how pnpm’s node_modules are structured when

https://pnpm.io

フラットな node_modules が唯一の方法ではありません | pnpm

pnpm の新規ユーザーから、pnpm が生成する node_modules の奇妙な構造についてよく聞かれます。 なぜ平坦な構造を使用しないのでしょうか。 依存のさらにその依存はどこにあるのでしょうか。

https://pnpm.io

node_modulesの問題点とその歴史 npm, yarnとpnpm

https://zenn.dev

pnpm の好きポイントを書いておこ | t28.dev

パッケージマネージャーに関しては パッケージマネージャーを管理するために依存関係を増やしたくない 🥺 nvm でバージョン指定した Node.js に内蔵されている npm を使えばいいじゃん 😘 という考えだったのですが、 pnpm を試しに使ってみると「いいなこれ…

https://t28.dev

pnpm の node_modules を探検して理解しよう - ドワンゴ教育サービス開発者ブログ

はじめに こんにちは。ドワンゴ教育事業でエンジニアをしているユーンです。 N予備校アプリケーションやその他複数のプロジェクトで pnpm を採用しました。pnpm とは何か、npm とどう違うのかというのを node_modules の構造を追いながら理解しつつ、教育事業での採用した結果についてお話します。 pnpm とは pnpm とは、npm や yarn とレイヤーを同じくするパッケージマネージャであり、サードパーティのものです。 pnpm.io pnpm は他のツールと比較して高速でありディスク効率が良いと謳っています。 その pnpm の最大の特徴は、 node_modules の構…

https://blog.nnn.dev

つまり、pnpm では、dependencies に直接書いているパッケージしか読み込めないという制約が存在している。

Turborepo の例では、prisma をパッケージに閉じ込めているので、読み込み元からは prisma を直接呼び出せなくなる。

public-hoist-pattern に記載することでnode_modules 直下にディレクトリが巻き上げ（hoisting）され、直接読み込むことができるようになる。

Settings (.npmrc) | pnpm

pnpm gets its configuration from the command line, environment variables, and

https://pnpm.io