pnpm 是一款快速、节省磁盘空间的 Node.js 包管理器。它使用内容寻址存储(content-addressable store),对同一台机器上所有项目中的包进行去重,从而显著节省磁盘空间。pnpm 默认执行严格的依赖解析,防止出现幽灵依赖(phantom dependencies)。pnpm 专属配置建议优先放置在 pnpm-workspace.yaml 中。
使用注意:在处理 pnpm 项目时,代理应检查 pnpm-workspace.yaml 与 .npmrc 文件,以了解工作区结构与配置。在 CI 环境中应始终使用 --frozen-lockfile。
本技能基于 pnpm 10.x,生成于 2026-01-28。
核心主题
CLI 命令(core-cli):install、add、remove、update、run、exec、dlx 以及工作区命令。
配置(core-config):pnpm-workspace.yaml、.npmrc 设置以及 package.json 字段。
工作区(core-workspaces):通过过滤(filtering)、工作区协议(workspace protocol)与共享锁文件(shared lockfile)支持 monorepo。
存储(core-store):内容寻址存储、硬链接与磁盘效率。
特性主题
Catalogs(features-catalogs):面向工作区的集中式依赖版本管理。
Overrides(features-overrides):强制指定依赖(包括传递依赖)的特定版本。
Patches(features-patches):通过自定义修复修改第三方包。
Aliases(features-aliases):使用 npm: 协议以自定义名称安装包。
Hooks(features-hooks):通过 .pnpmfile.cjs 钩子自定义解析。
Peer Dependencies(features-peer-deps):自动安装、严格模式与依赖规则。
最佳实践主题
CI/CD 设置(best-practices-ci):GitHub Actions、GitLab CI、Docker 与缓存策略。
迁移(best-practices-migration):从 npm/Yarn 迁移、处理幽灵依赖、monorepo 迁移。
性能(best-practices-performance):安装优化、存储缓存、工作区并行化。