通过npm安装Vercel CLI后无法使用：vercel命令未找到

我通过以下npm命令全局安装了Vercel CLI：

npm install -g vercel

但运行vercel --version时出现错误：

vercel --version
zsh: command not found: vercel

已尝试的排查步骤：

• 执行npm list -g --depth=0确认Vercel已全局安装，输出显示包含vercel@39.1.1：

npm list -g --depth=0
/opt/homebrew/Cellar/node/23.2.0_1/lib
├── corepack@0.29.4
└── vercel@39.1.1

• 执行which vercel命令，返回结果为空：

which vercel
vercel not found

系统信息：

• macOS系统
• Node.js版本：23.2.0（通过Homebrew安装）
• npm版本：9.5.0

问题出在npm全局二进制文件目录未加入zsh的PATH环境变量中，导致系统找不到vercel命令。按以下步骤修复：

1. 确认npm全局bin目录路径
   执行命令查看npm全局前缀路径：

npm config get prefix

Homebrew安装的Node通常会返回/opt/homebrew，对应的bin目录为/opt/homebrew/bin。

2. 将bin目录添加到zsh的PATH
   编辑zsh配置文件（一般是~/.zshrc或~/.zprofile），添加一行：

export PATH="/opt/homebrew/bin:$PATH"

如果步骤1得到的前缀是其他路径（比如~/.npm-global），则替换为对应bin路径（如~/.npm-global/bin）。

3. 生效配置并验证
   执行命令重新加载配置：

source ~/.zshrc

或直接重启终端。之后运行which vercel，能看到命令路径即表示成功，再执行vercel --version即可正常显示版本。

若上述方法无效，可尝试安装时指定prefix：

npm install -g vercel --prefix /opt/homebrew

内容的提问来源于stack exchange，提问作者Yousseif Muhammed