pnpm 安装后无法使用

这个问题很常见,是因为 pnpm 的全局安装路径没有包含在系统的 PATH 环境变量中。

🔍 问题原因

当你使用 npm i -g pnpm 安装时,pnpm 被安装到了 npm 的全局目录,但这个目录可能不在你的 PATH 中。

🛠️ 解决方案

方案1:找到并配置 PATH(推荐)

  1. 找到 npm 的全局安装路径:

    bash
    npm config get prefix

    这会返回一个路径,通常是 /usr/local 或 /Users/你的用户名/.npm-global

  2. 将路径添加到 PATH:

    • 如果你使用的是 zsh(macOS 默认):

      bash
      echo 'export PATH="'$(npm config get prefix)'/bin:$PATH"' >> ~/.zshrc
      source ~/.zshrc
    • 如果你使用的是 bash:

      bash
      echo 'export PATH="'$(npm config get prefix)'/bin:$PATH"' >> ~/.bash_profile
      source ~/.bash_profile
  3. 验证是否生效:

    bash
    pnpm -v

方案2:使用 nvm 管理 Node.js(一劳永逸)

如果你经常遇到这类问题,建议使用 nvm:

  1. 安装 nvm:

    bash
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
  2. 重新打开终端,安装 Node.js:

    bash
    nvm install --lts
    nvm use --lts
  3. 重新安装 pnpm:

    bash
    npm install -g pnpm

方案3:直接使用完整路径

临时解决方案,使用完整路径运行 pnpm:

bash
# 用刚才找到的路径
/usr/local/bin/pnpm -v
# 或者
$(npm config get prefix)/bin/pnpm -v
posted @ 2025-09-28 21:12  egreen  阅读(78)  评论(0)    收藏  举报