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*"
相关推荐
研究点啥好呢1 分钟前
Muses | 搭建属于你自己的AI生图网站
前端·人工智能·ai·github
aircrushin2 分钟前
给宝宝办了个宴,朋友用trae做的工具帮了大忙
前端·后端
程序员Sunday11 分钟前
爆肝万字!这应该是全网最全的 Codex 实战教程了
前端·后端·ai编程
aircrushin12 分钟前
朋友用trae搭建的工具,解决了旅行拍照共享的大事儿
前端·后端
ZC跨境爬虫17 分钟前
跟着 MDN 学 HTML day_41:(DOMParser 接口详解)
前端·javascript·ui·html·音视频
光影少年30 分钟前
useLayoutEffect 和 useEffect 区别、使用场景
开发语言·前端·javascript
LIO41 分钟前
掌握 React useEffect:核心概念、使用技巧与常见陷阱
前端·react.js
XD7429716361 小时前
科技早报晚报|2026年5月12日:GUI Agent、编程会话工作台与 npm 安装门禁,今晚更值得做的 3 个技术机会
前端·科技·npm·供应链安全·ai agent·开发者工具
前端那点事1 小时前
Vue3 新趋势:10个高阶实用操作|性能优化+开发提效+避坑指南
前端·vue.js
small_white_robot1 小时前
idek-2022 web 全wp——持续更新
开发语言·前端·javascript·网络·安全·web安全·网络安全