pnpm:public-hoist-pattern[]配置

在 pnpm 中,public-hoist-pattern[] 是用于控制依赖提升(Hoisting)的一个重要配置项。

核心作用

它的主要作用是允许符合特定规则的第三方依赖被提升到根目录的 node_modules 中,从而使其对项目中的所有代码(包括未在 package.json 中显式声明该依赖的代码)可见。

为什么需要它?

  • pnpm 默认使用符号链接的方式管理依赖

  • 大多数依赖不会被提升到顶层 node_modules,而是存放在 .pnpm 文件夹中

  • 这样可以避免幽灵依赖问题,但也可能导致某些包无法被正确访问

为什么需要这个配置
  • @aurora 作用域下的包可能是内部私有包

  • 这些包可能在构建、运行或插件机制中需要直接访问(例如通过 require('@aurora/xxx'))

  • 通过强制提升,确保这些包始终在 node_modules 顶层,避免因路径解析失败导致的问题

配置规则与默认值

默认值:通常默认为 ['eslint ', 'prettier ']。这意味着任何名称包含 eslint 或 prettier 的包都会被自动提升。

配置位置:在项目根目录的 .npmrc 文件中定义。

语法示例:

ini

提升所有以 @types/ 开头的包和所有包含 babel 的包

public-hoist-pattern[]=@types/*

public-hoist-pattern[]=babel

使用 ! 符号可以排除特定包(从 v7.12.0 开始支持)

public-hoist-pattern[]=!@types/react

请谨慎使用此类代码。

与 hoist-pattern 的区别

hoist-pattern:将匹配的包提升到 node_modules/.pnpm/node_modules(一个隐藏的、由 pnpm 内部管理的目录)。

public-hoist-pattern:将匹配的包直接提升到根目录 node_modules,对外部环境完全可见。

pnpm10中的使用

publicHoistPattern

默认值:[]

类型:string[]

不同于 hoist-pattern 会把依赖提升到一个虚拟存储中的隐藏的模块目录中,publicHoistPattern 将匹配的依赖提升至根模块目录中。 提升至根模块目录中意味着应用代码可以访问到幻影依赖,即使它们对解析策略做了不当的修改。

当处理一些不能正确解析依赖关系的有缺陷可插拔工具时,此设置很有用。

例如:

javascript 复制代码
publicHoistPattern:
 - "*plugin*"
 -  "*aurora*"
 - "*@wetest*"
 - "*@types*"
 - "*eslint*"
相关推荐
我叫黑大帅2 小时前
Js常用数组处理
前端·javascript·面试
敲代码的约德尔人2 小时前
React useEffect 完全指南:我在 3 个项目中踩坑后总结的血泪经验
前端·react.js
小凡同志2 小时前
React 组件设计模式:从 HOC 到 Render Props 再到 Hooks
前端·react.js
毛骗导演2 小时前
OpenClaw Auth Profile 与多 Key 冷却隔离机制深度解析:一个 API Key 是如何被选择、追踪并轮换的
前端·架构
用户9751470751362 小时前
如何在 Vite 中配置 CSS 模块,以避免全局样式被模块化隔离覆盖?
前端
我叫黑大帅2 小时前
Js常用的字符串处理
前端·javascript·面试
栀秋6662 小时前
深入浅出:手写一个迷你版 Zustand
前端·react.js·前端框架
gustt2 小时前
手写 Zustand:从零实现 React 轻量级状态管理库
前端·面试
读忆2 小时前
在前端开发中使用组件后, 若是出了bug, 应该如何排查, 怎么排查, 解决方式是什么?
前端·javascript·vue.js·bug