Redocly CLI命令未找到求助：全局安装后仍无法运行

以下是几个逐步排查和解决的方案：

1. 刷新zsh命令缓存 #

zsh可能缓存了命令列表，先执行刷新命令：

rehash

之后再尝试运行redocly lint openapi.yaml。

2. 确认npm全局包路径是否在zsh的PATH中 #

• 先查看npm全局包的安装根目录：

  npm root -g
  

  通常输出类似/usr/local/lib/node_modules或~/.npm-global/lib/node_modules，对应的bin目录是根目录同级的bin文件夹（比如/usr/local/bin或~/.npm-global/bin）。
• 检查该bin目录是否在zsh的PATH里：

  echo $PATH
  

• 如果不在，需要将其添加到zsh配置文件（~/.zshrc）中：
  打开配置文件：

  open ~/.zshrc
  

  添加一行（替换成你的实际bin路径）：

  export PATH="$PATH:/usr/local/bin"
  

  保存后生效配置：

  source ~/.zshrc
  

3. 验证Redocly CLI是否真的全局安装成功 #

执行命令查看全局安装的Redocly版本：

npm list -g @redocly/cli

如果输出显示"empty"或找不到包，说明安装未成功，可能是权限问题：

• 避免用sudo安装全局包，建议修改npm全局目录权限：

  mkdir ~/.npm-global
  npm config set prefix '~/.npm-global'
  

  然后将~/.npm-global/bin添加到PATH（参考步骤2），之后重新安装：

  npm install @redocly/cli -g
  

4. 检查Node.js版本是否变更 #

如果使用nvm等版本管理工具，可能不小心切换了Node.js版本，导致全局包不在当前版本的路径中：

• 查看当前Node.js版本：

  node -v
  

• 切换回之前使用的版本（比如v18.17.0）：

  nvm use 18.17.0
  

  之后重新安装Redocly CLI即可。

内容的提问来源于stack exchange，提问作者B Ahern