Pnpm 9 + Monorepo：大型前端项目的依赖管理最佳实践
Pnpm 9 + Monorepo: Dependency Management Best Practices for Large Frontend Projects
| iDev Team | 2026-07-29T09:00:00
当前端项目膨胀为多个子应用、组件库和工具包时，依赖管理变得极其复杂。本文介绍如何用 Pnpm 9 的 Workspace 功能高效管理 Monorepo 项目。
When frontend projects expand into multiple sub-apps, component libraries, and utility packages, dependency management becomes extremely complex. This article shows how to efficiently manage Monorepo projects with Pnpm 9 Workspace.
为什么选择 Pnpm相比 npm 和 yarn，Pnpm 在 Monorepo 场景下有三个显著优势：磁盘空间节省：通过硬链接和内容寻址存储，相同依赖只保留一份副本安装速度更快：比 npm 快 2-3 倍严格的依赖隔离：防止幽灵依赖（phantom dependencies）Monorepo 项目结构my-monorepo/ ├── pnpm-workspace.yaml ├── package.json ├── packages/ │ ├── ui/ # 共享组件库 │ ├── utils/ # 工具函数 │ └── config/ # 共享配置 └── apps/ ├── web/ # 主站 ├── admin/ # 管理后台 └── mobile/ # 移动端核心配置# pnpm-workspace.yaml packages: - "packages/*" - "apps/*"常用命令# 安装所有包的依赖 pnpm install # 只在某个包中安装依赖 pnpm --filter @my/web add axios # 运行某个包的脚本 pnpm --filter @my/web dev # 并行运行所有包的 build pnpm -r run build # 只构建有变更的包 pnpm -r --filter ...[origin/main] run buildPnpm 9 新特性Catalogs：在 workspace 级别统一管理依赖版本改进的 lockfile：更快的解析速度和更好的 Git 合并体验增强的 --filter：支持基于 Git diff 的增量构建实战技巧使用 Turborepo 或 Nx 配合 Pnpm 实现智能缓存和并行构建在 CI 中使用 pnpm deploy 命令生成精简的生产部署包配置 .npmrc 中的 shared-workspace-lockfile=true 确保一致性
Why PnpmCompared to npm and yarn, Pnpm has three significant advantages in Monorepo scenarios:Disk Space Savings: Through hard links and content-addressable storage, identical dependencies are stored only onceFaster Installation: 2-3x faster than npmStrict Dependency Isolation: Prevents phantom dependenciesMonorepo Project Structuremy-monorepo/ ├── pnpm-workspace.yaml ├── package.json ├── packages/ │ ├── ui/ # Shared component library │ ├── utils/ # Utility functions │ └── config/ # Shared configuration └── apps/ ├── web/ # Main site ├── admin/ # Admin panel └── mobile/ # Mobile appCore Configuration# pnpm-workspace.yaml packages: - "packages/*" - "apps/*"Common Commands# Install all package dependencies pnpm install # Install a dep in a specific package pnpm --filter @my/web add axios # Run a script in a specific package pnpm --filter @my/web dev # Build all packages in parallel pnpm -r run build # Build only changed packages pnpm -r --filter ...[origin/main] run buildPnpm 9 New FeaturesCatalogs: Manage dependency versions at the workspace levelImproved Lockfile: Faster parsing and better Git merge experienceEnhanced --filter: Supports incremental builds based on Git diffsPractical TipsUse Turborepo or Nx with Pnpm for smart caching and parallel buildsUse pnpm deploy in CI to generate lean production deployment packagesConfigure shared-workspace-lockfile=true in .npmrc for consistency