Skip to content

pnpm 支持

pnpm 的支持目前是实验性的。要启用它,请确保环境变量 VOLTA_FEATURE_PNPM 设置为 1。在 Windows 上,可以在系统设置中将其添加到用户或系统环境变量中。在 Linux/Mac 上,您可以在配置文件脚本(例如 .bash_profile.zshrc 或类似文件)中设置该值。

由于此支持是实验性的,可能存在一些未解决的问题。下面列出了一些已知的限制,但是如果您在使用 Volta 的 pnpm 时遇到任何不按预期工作的情况,请在我们的 GitHub 上提出问题。

已知限制

全局安装

目前,不支持全局安装(例如 pnpm install -g),会导致错误。

迁移

目前没有自动迁移,所以如果您之前将 pnpm 作为 Volta 全局安装,您需要通过调用 volta install pnpm 手动重新安装它。在启用支持并进行重新安装之前,您可以通过 volta uninstall pnpm 卸载先前安装的 pnpm 包。一旦您切换到原生 pnpm 支持,由于目前缺乏卸载实现,您无法通过调用相同命令删除隔离的旧 pnpm 包。

启用 pnpm 支持

在 Unix(Linux/macOS)上

将以下行添加到您的 shell 配置文件(.bashrc.zshrc 等):

bash
export VOLTA_FEATURE_PNPM=1

然后重新加载您的 shell 或运行:

bash
source ~/.bashrc  # 或您的特定配置文件

在 Windows 上

  1. 打开开始菜单并搜索"环境变量"
  2. 点击"编辑系统环境变量"
  3. 在系统属性窗口中,点击"环境变量"
  4. 在"用户变量"下,点击"新建"
  5. 输入"VOLTA_FEATURE_PNPM"作为变量名,"1"作为值
  6. 点击"确定"关闭所有对话框

使用 Volta 与 pnpm

启用 pnpm 支持后,您可以:

  1. 安装 pnpm 作为您的默认包管理器:
bash
volta install pnpm
  1. 在项目中固定特定的 pnpm 版本:
bash
volta pin pnpm@7.14.0
  1. 查看已安装的 pnpm 版本:
bash
volta list pnpm

故障排除

如果您在 Volta 中遇到 pnpm 问题:

  1. 验证功能标志是否正确设置:

    • 在 Unix 上:echo $VOLTA_FEATURE_PNPM
    • 在 Windows 上:echo %VOLTA_FEATURE_PNPM%
  2. 检查 pnpm 是否正确安装:

    • 运行 volta list 查看 pnpm 是否出现在列表中
  3. 对于任何其他问题,请在 Volta GitHub 仓库上报告它们。