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 上
- 打开开始菜单并搜索"环境变量"
- 点击"编辑系统环境变量"
- 在系统属性窗口中,点击"环境变量"
- 在"用户变量"下,点击"新建"
- 输入"VOLTA_FEATURE_PNPM"作为变量名,"1"作为值
- 点击"确定"关闭所有对话框
使用 Volta 与 pnpm
启用 pnpm 支持后,您可以:
- 安装 pnpm 作为您的默认包管理器:
bash
volta install pnpm
- 在项目中固定特定的 pnpm 版本:
bash
volta pin pnpm@7.14.0
- 查看已安装的 pnpm 版本:
bash
volta list pnpm
故障排除
如果您在 Volta 中遇到 pnpm 问题:
验证功能标志是否正确设置:
- 在 Unix 上:
echo $VOLTA_FEATURE_PNPM
- 在 Windows 上:
echo %VOLTA_FEATURE_PNPM%
- 在 Unix 上:
检查 pnpm 是否正确安装:
- 运行
volta list
查看 pnpm 是否出现在列表中
- 运行
对于任何其他问题,请在 Volta GitHub 仓库上报告它们。