ConfigsApr 11, 2026·1 min read

pnpm — Fast, Disk-Space Efficient Package Manager

pnpm is a fast, disk-space efficient package manager for Node.js. Uses a content-addressable store and symlinks to avoid duplicating packages across projects — saves gigabytes and installs 2x faster than npm.

AI
AI Open Source · Community
Quick Use

Use it first, then decide how deep to go

This block should tell both the user and the agent what to copy, install, and apply first.

# Install
npm install -g pnpm
# Or via Corepack (Node 16+)
corepack enable

# Use in a project
pnpm install
pnpm add react
pnpm dlx create-vite my-app

Monorepo workspace:

# pnpm-workspace.yaml
packages:
  - "apps/*"
  - "packages/*"
pnpm -r build        # run build in all packages
pnpm --filter web dev # run dev in the web package
Intro

pnpm is a fast, disk-space efficient package manager. Uses a content-addressable store + symlinks so every version of every package exists once on disk, shared across all your projects. Solves npm/yarn disk bloat and duplication.

What pnpm Does

  • Fast installs — 2-3x faster than npm
  • Disk efficient — global content-addressable store (~/.pnpm-store)
  • Strict node_modules — no phantom dependencies
  • Monorepo — first-class workspace support
  • Deterministic — pnpm-lock.yaml
  • Catalogs — shared version ranges across workspace
  • Patches — patch-package built in

Architecture

Global store at ~/.pnpm-store/v3 holds all package tarballs (content-addressed). Each project gets a node_modules/.pnpm directory with hardlinks to the store, then symlinks in node_modules/ to expose direct deps. Non-direct deps stay hidden (no phantom deps).

Self-Hosting

CLI tool — install locally, no server.

Key Features

  • 2-3x faster than npm/yarn classic
  • Up to 50% disk space savings
  • Strict dependency resolution
  • Workspace/monorepo first-class
  • pnpm dlx for one-off commands
  • Built-in pnpm patch for upstream fixes
  • Catalogs (v9+) for shared versions
  • Side-effects cache

Comparison

Manager Speed Disk Monorepo Strict
pnpm Fast Best First-class Yes
Yarn Berry Fast Medium First-class PnP
npm Slowest Worst Workspaces No
Bun Fastest Good Basic No

常见问题 FAQ

Q: 会破坏现有项目吗？ A: 少数依赖 phantom deps 的老包会报错。解决：把它们加到 package.json 或用 public-hoist-pattern。

Q: 和 Turborepo/Nx 配合？ A: 完美配合。pnpm 管依赖，Turborepo/Nx 管任务编排和缓存。

Q: 能替换 Yarn workspace 吗？ A: 能。迁移通常只需改 package.json 的 workspaces 为 pnpm-workspace.yaml。

来源与致谢 Sources

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

esbuild — Extremely Fast JavaScript Bundler

esbuild is an extremely fast JavaScript/TypeScript bundler written in Go. 10-100x faster than webpack/Rollup. Powers Vite, Bun, and many modern build tools as their underlying transform engine.

AI Open Source

Redux — Predictable Global State Management for JS Apps

Redux is the original predictable state container for JavaScript apps. Modern Redux uses Redux Toolkit (RTK) which reduces boilerplate 80% and includes RTK Query for server state. Still the standard for large-scale React apps.

AI Open Source

UnoCSS — Instant On-Demand Atomic CSS Engine

UnoCSS is the instant on-demand atomic CSS engine. Inspired by Tailwind/Windi but engine-first: define your own utilities, presets, and rules. 5x faster than Tailwind JIT with no parsing or AST overhead.

AI Open Source
◈Home🔍Search👤Me