SuperAPI AI 工具集

pnpm

通用与其它

查看项目

更新于 10-15 16:49

技能介绍

用途:pnpm 是快速、磁盘空间高效的 Node.js 包管理器,使用内容寻址存储在同机所有项目间去重依赖,并默认严格解析依赖,防止幽灵依赖(phantom dependencies)。本资料基于 pnpm 12.x,同时覆盖 v11 行为;v12 是 v11 的 Rust 重写版,保留 v11 的命令、标志、设置与 lockfile 格式,少数行为有差异(如 git 依赖经 HTTPS 解析、项目感知的全局 bin、Linux 上 packageImportMethod: auto 优先硬链接、移除 --resolution-only 等)。

配置模型:设置位于 pnpm-workspace.yaml(及全局 config.yaml),使用 camelCase 键;.npmrc 仅用于认证/registry 凭据,package.json 的 pnpm 字段不再读取。在 pnpm 项目中应查看 pnpm-workspace.yaml 获取设置与工作区结构,.npmrc 只看认证。CI 中始终使用 --frozen-lockfile(或 pnpm ci)。

主要能力:CLI 命令(install/add/remove/update、run、dlx/pnx、workspace、runtime、发布相关 version/view/sbom/stage);配置(pnpm-workspace.yaml 设置、全局 config.yaml、packageConfigs、.npmrc 认证);工作区(monorepo 过滤、workspace 协议、共享 lockfile);存储(内容寻址存储、虚拟存储、node linker 模式、只读存储)。特性包括 Catalogs 集中管理版本、Overrides 强制版本、Patches 修改第三方包、Aliases、.pnpmfile.mjs 钩子、peer 依赖处理、通过 configDependencies 共享配置、全局虚拟存储与 shims、供应链安全(allowBuilds 构建批准、minimumReleaseAge、trustPolicy、lockfile 完整性)、跨项目任务编排(tasks/dependsOn)、原生版本发布管理(pnpm change/version -r/lane、lanes、epics)、多生态(实验性 Python pypi: 与 Cargo crate: 依赖)。

适用场景:Node.js 项目与 monorepo 的依赖安装、工作区管理与 CI/CD;需严格依赖隔离、节省磁盘、供应链安全控制的团队。相关最佳实践涵盖 CI/CD(GitHub Actions、GitLab、Docker、store 缓存)、从 npm/Yarn 迁移及 v10→v11→v12 升级、性能优化。

限制:本资料为技能文档,未提供具体安装命令、URL 或代码示例;部分能力(如 Python/Cargo 支持)标注为实验性;v12 与 v11 存在少量行为差异。