pnpm Workspaces für Monorepos

pnpm (Performant npm) ist ein schneller, platzsparender Paketmanager. Es speichert eine einzige Kopie jedes Pakets in einem globalen inhaltsadressierbaren Store und verknüpft Projekte aus deren node_modules damit. Dieselbe Abhängigkeit in mehreren Projekten bedeutet also nur eine Kopie auf der Festplatte.

In einem typischen Monorepo sind Installationen mit pnpm 2- bis 3-mal schneller als mit npm/yarn und benötigen etwa 70 % weniger Speicherplatz. Besonders bei Monorepos mit vielen Paketen ergibt sich ein großer Vorteil.

Verwenden Sie Corepack (in Node 16+ enthalten) oder installieren Sie pnpm global.

Erstellen Sie im Stammverzeichnis eine pnpm-workspace.yaml, in der die Ordner mit Paketen aufgeführt sind.

Jede Anwendung und jedes Paket verfügt über eine eigene package.json. Im Stammverzeichnis befindet sich eine Workspace-package.json mit gemeinsam genutzten devDeps.

Führen Sie einmal im Stammverzeichnis pnpm install aus. pnpm installiert alles in allen Paketen und führt gemeinsame Abhängigkeiten per Hoisting nach oben.

Referenzieren Sie interne Pakete mit workspace:*. pnpm löst dies zum lokalen Paket auf; beim Veröffentlichen wird es durch eine echte Version ersetzt.

pnpm -r führt ein Skript in jedem Paket aus. Verwenden Sie --filter für Teilmengen.

Standardmäßig verwendet pnpm symbolische Links, sodass ein Paket nur die Abhängigkeiten sieht, die es ausdrücklich in seiner package.json aufgeführt hat. Dadurch gelangen Abhängigkeiten nicht versehentlich aus anderen Paketen hinein — ein Fehler, den npm und yarn classic beide zulassen.

Standardmäßig führt pnpm kein Hoisting durch. Wenn eine transitive Abhängigkeit zugänglich sein muss (z. B. ein globales TypeScript), ergänzen Sie in .npmrc: shamefully-hoist=true (möglichst vermeiden) oder verwenden Sie ein spezifisches public-hoist-pattern.

pnpm update aktualisiert innerhalb der semver-Bereiche. pnpm update -L aktualisiert auf die neueste Version (ignoriert das Caret).

pnpm stellt Workspace- und Installationsfunktionen bereit; Turborepo übernimmt die Aufgabenorchestrierung und das Caching. Beide ergänzen sich perfekt — die meisten JS-Monorepos verwenden sie gemeinsam.

Speichern Sie den inhaltsadressierbaren Store von pnpm (~/.local/share/pnpm/store) im Cache, um CI-Läufe zu beschleunigen. Verwenden Sie --frozen-lockfile, damit der Lauf fehlschlägt, wenn sich pnpm-lock.yaml ändern würde.

Was ist der wichtigste Vorteil von pnpm gegenüber npm/yarn hinsichtlich des Speicherplatzes in einem Monorepo?

Ein einziger inhaltsadressierbarer Store + symbolische Links ergeben schnelle Installationen und etwa 70 % weniger Speicherplatzbedarf. pnpm-workspace.yaml listet die Paketordner auf. Das workspace:*-Protokoll dient für interne Abhängigkeiten. pnpm -r führt Skripte in allen Paketen aus; --filter für Teilmengen. Die strikte Auflösung verhindert durchlässige Abhängigkeiten. Kombinieren Sie pnpm mit Turborepo für die Aufgabenorchestrierung. Verwenden Sie in CI --frozen-lockfile.