SuperAPI AI 工具集

npm-to-pnpm

部署与运维

查看项目

更新于 10-15 20:12

技能介绍

用途:当贡献者需要在本仓库中从 npm 切换到 pnpm 时使用该技能,按步骤完成环境检查、Node 升级与依赖安装。

主要能力与用法:

  1. 检查 pnpm 是否已安装:运行 pnpm -v。若成功且主版本为 10 或以上,说明已就绪,告知用户并停止;若低于 10,提示版本过旧并继续升级。
  2. 检查 Node 版本:运行 node -v,解析主版本。若为 24 或以上,跳到第 3 步;低于 24 则升级。
  3. 升级 Node 到 v24:依次尝试版本管理器。nvm 可用时运行 nvm install 与 nvm use(仓库 .nvmrc 设为 24,会自动安装并激活正确版本);nvm 不可用则检查 volta,可用时运行 volta install node@24 与 volta install corepack;两者都不可用时,提示用户按 https://www.nvmnode.com/guide/installation.html#nvm-install 安装 nvm 后重试,并在此停止。
  4. 通过 corepack 启用 pnpm:运行 corepack enable pnpm。
  5. 用 pnpm 安装依赖:删除旧的 npm 锁文件并安装,运行 rm -f package-lock.json 与 pnpm install --frozen-lockfile。
  6. 告知用户 pnpm 已配置完成,后续应使用 pnpm 命令(如 pnpm install、pnpm run dev、pnpm run build),package-lock.json 已删除,仓库改用 pnpm-lock.yaml。

适用场景:本仓库贡献者从 npm 迁移到 pnpm 的本地环境准备。

限制:该技能针对本仓库,依赖 .nvmrc 与 pnpm-lock.yaml;未提供其他包管理器或平台的替代方案,也未说明失败回滚方式。