跳到正文
小佑Blog 站点标识小佑Bloglordblog.cn

pnpm 11 发布:默认开启隔离安装

工程化约 6 分钟

pnpm 在 6 月 26 日发布 11.0,把隔离安装设为默认,官方在一个 2000 个包的项目上测得幽灵依赖引用从 47 处降到 0。

在笔记本上敲代码并放着一杯咖啡
2026-06-26 · 终端里滚动的依赖安装日志与模块链接信息

隔离安装的意思是只有声明在 package.json 里的包才能被 import。此前这个行为要手动开,很多项目图省事没开,结果代码里悄悄引用了某个二级依赖,升级一次就全线报错。11.0 把它变成默认,并在安装结束时打印一份“未声明引用”清单。

安装速度也有变化。官方基准显示,冷安装 2000 个包从 74 秒降到 58 秒,二次安装从 21 秒降到 14 秒,主要来自存储层索引的重写。磁盘占用平均下降 11%,因为硬链接的复用率提高了。

破坏性变化集中在两处:一是 lifecycle 脚本默认不再自动执行,需要在配置里显式允许;二是工作区的依赖提升规则改了,monorepo 里跨包引用要写清版本范围。官方给了 codemod,可批量补全 3 类配置。

升级路径

建议先在 CI 上跑一遍 dry-run,重点看输出的未声明引用清单。官方在 400 个开源项目上做了预演,平均每个项目发现 6.3 处问题,其中 2.1 处会导致构建失败。处理方式是补声明或改引用路径,两者都不难,但需要逐个核对。

11.0 要求 Node 22 以上,这与 Node 26 LTS 的时间点吻合。团队计划在 2027 年一季度移除对 Node 22 的支持,把下限提到 24。

隔离安装的副作用要评估。项目里若有依赖靠提升到顶层才能被找到的包,切换后会直接报错;官方给了 11 行的检查脚本,能列出所有隐式依赖。2000 个包的仓库跑一遍约 40 秒,建议先跑再切;另外 CI 的缓存键要把 pnpm 版本算进去,否则换版本后仍会命中旧缓存,症状是“本地好、CI 报错”。

与这条动态相关的两期专栏