New Hot

pnpm 12.22.0 发布:新增全局包配置段与 why --ranges,并修复仓库切换安全校验

pnpm包管理器Node.js安全更新依赖解析

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

搜索文章

输入关键词,快速查找标题和正文内容。