Skip to content

安装包管理器 pnpm ​

我们项目使用的包管理器,默认使用 npm,而不是 pnpm。但是我要求大家使用 pnpm。

准备 pnpm 包管理器 ​

本项目原本有内置的脚本帮助你安装 pnpm,按理说你并不需要手动去安装 pnpm。但是我们关闭了该功能。

如果你想在本项目使用 pnpm,请依次运行以下命令。

bash
corepack -v
corepack enable
corepack use pnpm@latest

运行效果如下:

用 corepack 安装 pnpm

2026-03-11-18-01-58

包管理器配置与强约束 ​

你也许注意到我们的包管理器配置仍旧是固定的 pnpm。

json
{
	"packageManager": "pnpm@10.32.1"
}

你仍旧可以正常使用 npm,我们项目没有配置严格引擎校验。如果你使用的不是 pnpm,你可以忽略该字段。

corepack 存在严重的 bug ​

我们目前的 node 版本使用的是低版本的 corepack,会导致你安装 pnpm 失败。你应该至少使用 node22.14.0 以上版本的 node 环境,因为该版本的 node 环境提供 corepack0.31.0 版本。可以有效解决 pnpm 安装出现的 key 值校验故障。

点此阅读详情。

win 专业版需要额外设置解除文件名限制 ​

具体做法请点此文章。

win11 家庭版不推荐继续使用 pnpm ​

win11 家庭版无法有效地在策略组里面设置启用NTFS长路径策略,你安装的依赖很有可能会出现文件名长度超限的情况。

你可以缩减项目根目录的文件名长度,尽可能减少长度,不超过 255 的限制。

这毕竟是缓兵之计,如果你是 win11 家庭版,我们建议你用 npm。

或者将 win11 家庭版升级到 win11 专业版,然后再去设置策略组。

贡献者

The avatar of contributor named as ruan-cat ruan-cat

页面历史

最近更新