pnpm 12.22.0 发布:新增全局包配置段与 why --ranges,并修复仓库切换安全校验
pnpm 12.22.0 发布,全局包设置可独立写入 globalPackagesConfig,新增 pnpm why --ranges 与按依赖顺序输出的递归列表,并修复仓库切换后跳过最小发布年龄与信任策略校验的问题。工作区与私有源用户建议跟进。
pnpm 12.22.0 新增全局包配置段并修复仓库切换校验
pnpm 12.22.0 新增全局包专属配置段与 why --ranges,并修复了仓库切换后跳过安全校验的问题。
全局包配置独立成段
全局 config.yaml 新增 globalPackagesConfig,只作用于 pnpm add -g、pnpm update -g 这类全局包命令。例如 globalPackagesConfig.trustPolicyExclude 只对全局安装排除某个包的信任策略检查。pnpm approve-builds -g 与 pnpm add -g --allow-build 会把构建决定写到 globalPackagesConfig.permissions;全局包目录里 pnpm-workspace.yaml 的构建设置仍然生效,但会出现弃用警告。
依赖关系更容易排查
pnpm why --ranges 会列出每个直接依赖为某个包声明的版本范围,pnpm why --json 在 requires 字段里带上这些范围。pnpm list --recursive 现在按依赖顺序列出工作区项目,加 --no-sort 则保留原有工作区顺序。对多包仓库来说,排查谁引入了某个版本会更直接。
安全校验修复
默认仓库或某个 scoped 仓库变更后,pnpm install 会重新校验 lockfile 里的解析结果。此前它会复用上一个仓库缓存的结果,跳过 minimumReleaseAge 与 trustPolicy 检查。(来源:pnpm 官方发布说明)
官方原文称:“pnpm install now re-verifies lockfile resolutions when the default registry or a scoped registry changes.” 同一版本的补丁部分还让 pnpm dlx 不再复用宽松设置下的缓存安装,并修复 pnpm audit 丢弃字符串类型公告 ID 的问题。
全局配置与私有源切换的隐患被拆开处理
多包仓库、全局 CLI 工具与使用私有源的团队是这次更新的主要受益者。
全局安装配置更清晰
此前全局包与项目包的配置混在一起,容易互相干扰。拆出 globalPackagesConfig 后,全局装的命令行工具可以单独设置信任策略与构建权限,不再影响项目内安装。
私有源切换不再留隐患
CI 里经常在公共源与私有源之间切换。从官方描述看,重新校验锁文件的解析结果能避免沿用旧源缓存,降低供应链风险,但也会让首次安装多一次校验开销。
锁文件与部署的修复
v13 锁文件格式现在把本地目录包声明的说明符记录在 dependencies 与 optionalDependencies 中,并移除了 dependenciesMeta 字段。pnpm deploy 会保留 lockfile.format,避免部署后的项目把 v13 锁文件当成 v9 处理。相关对比也可以参考 Yarn 4.18.1 修复说明。
升级 12.22.0 需重写 v13 锁文件并迁移全局设置
使用工作区、私有源或全局工具的团队建议升级。这是一次包含安全修复的小版本,风险较低。
谁适合现在升级
启用了 v13 锁文件格式、在 CI 中切换仓库、或频繁使用 pnpm dlx 的项目收益最直接。只用公共源、单包安装的项目可以按计划跟进。
怎么升级
把 pnpm 升到 12.22.0 即可。若使用 v13 锁文件格式,需要执行一次 pnpm install 重写旧版本写出的锁文件;全局包相关设置要从 pnpm-workspace.yaml 逐步迁到 config.yaml。
迁移与兼容
官方给出弃用警告,说明全局包目录里的构建设置仍会被读取,但后续审批结果会写入 config.yaml。包管理器选型上的横向信息,可以看 Bun 1.4.4 更新解读。
常见问题
- pnpm 12.22.0 的 globalPackagesConfig 有什么作用?
- 它只对全局包命令生效,例如 globalPackagesConfig.trustPolicyExclude 仅排除全局安装的信任策略检查。
- pnpm 12.22.0 新增的 why --ranges 能做什么?
- 它会列出每个直接依赖为某个包声明的版本范围,JSON 输出也会带上 requires 字段。
- pnpm 12.22.0 修复了哪个安全问题?
- 默认或 scoped 仓库变更后,install 会重新校验锁文件解析结果,不再跳过最小发布年龄与信任策略检查。
- pnpm 12.22.0 升级后需要重新生成锁文件吗?
- 只有在使用 v13 锁文件格式时,旧版本写出的锁文件需要执行一次 pnpm install 重写。
相关术语
- pnpm
- pnpm 是面向 Node.js 的包管理器,用内容寻址存储和硬链接减少重复安装。
- lockfile
- lockfile 是记录依赖精确版本与解析结果的锁定文件,用来保证安装可重现。
- workspace
- workspace 是 pnpm 管理单仓库内多个包的方式,可在同一工程里共享依赖与版本约束。
- trustPolicy
- trustPolicy 是 pnpm 的信任策略配置,用来限制哪些依赖可以进入安装流程。
这篇文章的来源是什么?
文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。
- pnpm 12.22.0 · pnpm · 2026-11-18
「pnpm 12.22.0」 —— pnpm
文章目录