pnpm 是一个快速、磁盘空间高效的包管理器。它使用内容可寻址存储来对同一台机器上所有项目中的包进行去重,从而节省大量磁盘空间。pnpm 默认强制进行严格的依赖解析,防止幻影依赖。配置应优先放置在 pnpm-workspace.yaml 中,用于 pnpm 特定设置。
重要提示: 在使用 pnpm 项目时,代理应检查 pnpm-workspace.yaml 和 .npmrc 文件,以了解工作区结构和配置。在 CI 环境中始终使用 --frozen-lockfile。
该技能基于 pnpm 10.x,生成于 2026-01-28。
核心
| 主题 | 描述 | 参考 |
|---|---|---|
| CLI 命令 | install、add、remove、update、run、exec、dlx 及工作区命令 | core-cli |
| 配置 | pnpm-workspace.yaml、.npmrc 设置及 package.json 字段 | core-config |
| 工作区 | 支持过滤、工作区协议和共享锁文件的 monorepo | core-workspaces |
| 存储 | 内容可寻址存储、硬链接及磁盘效率 | core-store |
特性
| 主题 | 描述 | 参考 |
|---|---|---|
| 目录 | 工作区的集中式依赖版本管理 | features-catalogs |
| 覆盖 | 强制指定依赖(包括传递依赖)的特定版本 | features-overrides |
| 补丁 | 使用自定义修复修改第三方包 | features-patches |
| 别名 | 使用 npm: 协议以自定义名称安装包 | features-aliases |
| 钩子 | 使用 .pnpmfile.cjs 钩子自定义解析 | features-hooks |
| 对等依赖 | 自动安装、严格模式及依赖规则 | features-peer-deps |
最佳实践
| 主题 | 描述 | 参考 |
|---|---|---|
| CI/CD 设置 | GitHub Actions、GitLab CI、Docker 及缓存策略 | best-practices-ci |
| 迁移 | 从 npm/Yarn 迁移、处理幻影依赖、monorepo 迁移 | best-practices-migration |
| 性能 | 安装优化、存储缓存、工作区并行化 | best-practices-performance |