SuperAPI AI 工具集

pnpm

编程与开发

查看项目

更新于 10-16 06:38

技能介绍

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):安装优化、存储缓存、工作区并行化。