当前位置：首页 > 系统教程 > 正文

Mac安装pnpm完整教程（小白必看常见问题解答）

一步步教你如何在macOS上安装和使用pnpm包管理器

pnpm 是一个快速、节省磁盘空间的包管理器，相比npm和yarn有诸多优势。本文将详细介绍Mac安装pnpm的步骤，以及解决pnpm常见问题的方法，帮助初学者顺利完成pnpm包管理环境的搭建。

确保你的Mac已经安装了Node.js和npm。打开终端（Terminal），输入以下命令检查：

    node -vnpm -v

如果显示版本号，说明已安装；否则请前往Node.js官网下载安装LTS版本。

在终端执行以下命令：

    sudo npm install -g pnpm

输入密码后等待安装完成。这是最常见的pnpm安装方式。如果不想使用sudo，可以参考后面的常见问题解决权限问题。

如果你安装了Homebrew，可以运行：

    brew install pnpm

这种方法同样简单，适合macOS用户。

安装完成后，运行以下命令查看pnpm版本：

    pnpm --version

如果显示版本号（例如7.0.0），则说明pnpm包管理工具已成功安装。

你可以自定义pnpm的存储目录等，例如：

    pnpm config set store-dir ~/.pnpm-store

在Mac安装pnpm过程中，可能会遇到以下pnpm常见问题：

权限错误：安装时提示EACCES权限问题。解决方法：使用sudo执行安装，或者修改npm全局目录的所有者（sudo chown -R $(whoami) /usr/local/lib/node_modules）。
命令未找到：安装后输入pnpm提示command not found。这是因为npm全局bin目录（如/usr/local/bin）不在PATH环境变量中。可以将该目录加入shell配置文件（如~/.zshrc或~/.bash_profile），然后执行source ~/.zshrc。
安装速度慢：可以使用淘宝npm镜像加速。先设置npm registry：npm config set registry https://registry.npmmirror.com，然后再安装pnpm。
Node.js版本过低：pnpm要求Node.js版本12及以上。如果版本过低，请升级Node.js，可以使用brew upgrade node或从官网下载最新版。