pnpm的node_modules配置选项
· 一分钟阅读
创建node_modules目录结构有多种方式。 你一定想要创建最严格的结构,当然如果你当前的项目尚无法支持,你可以配置为不严格的。
默认配置
默认情况下,pnpm v5将创建一个“半严格”的node_modules。 “半严格”意味着您的应用程序将只能导入 package.json
中列出的依赖项(但也有例外)。 然而,你所依赖的那些包将能访问任何其他的包。
默认配置如下所示:
; 提升所有包到 node_modules/.pnpm/node_modules
hoist-pattern[]=*
; 提升所有名称包含types的包至根,以便Typescript能找到
public-hoist-pattern[]=*types*
; 提升所有ESLint相关的包至根
public-hoist-pattern[]=*eslint*
Plug'n'Play. 最严格的配置
自v5.9起,pnpm支持 Yarn的Plug'n'Play。 使用PnP,您的应用以及你所依赖的包都只能访问他们声明的依赖关系。 这比设置 hoist = false
更为严格,因为在monorepo中,您的应用甚至连根项目的依赖项也无法访问。
要使用 Plug'n'Play,请设置以下设置:
node-linker=pnp
symlink=false
严格的模块目录
如果您尚未准备好使用PnP,也可以通过将提升配置设置为false来仅允许程序包访问其自身的依赖项,确保其“严格”性:
hoist=false
但是,如果您的某些依赖项需要访问它们在依赖项中没有的程序包,则有两种选择:
-
创建
pnpmfile.js
并使用一个 hook 将缺少的依赖项添加到包的清单中。 -
添加到
hoist-pattern
中。 例如,如果未找到的模块是babel-core
,则将以下设置添加到.npmrc
:hoist-pattern[]=babel-core
最坏的情况 -- 提升至根
即使使用pnpm的默认配置,某些工具也可能无法工作,默认配置下所有内容都悬挂在虚拟存储的根目录中,而某些软件包则悬挂在根目录中。 在这种情况下,您可以将所有内容或部分依赖关系提升到modules目录的根目录。
要将所有内容提升到node_modules的根目录:
shamefully-hoist=true
按匹配规则提升:
public-hoist-pattern[]=babel-*