使用GitHub CLI登录时提示“gh: command not found”问题求助

1. 先确认GitHub CLI有没有安装 #

在终端里执行对应命令检查：

• macOS用Homebrew的话：brew list gh
• Debian/Ubuntu系统：apt list --installed gh

如果没有返回安装记录，说明GitHub CLI未安装，按以下方式安装：

各系统安装命令 #

• macOS：brew install gh
• Debian/Ubuntu：

  sudo apt update
  sudo apt install gh
  

• Windows：使用Chocolatey的话执行 choco install gh，也可以直接下载官方安装包手动安装

2. 已安装仍报错？检查PATH环境变量 #

终端输入 echo $PATH，查看gh的安装目录是否在输出的路径列表中：

• Homebrew安装的gh，路径通常是/usr/local/bin（Intel芯片Mac）或/opt/homebrew/bin（M系列芯片Mac）
• Debian/Ubuntu系统安装的gh，路径为/usr/bin

如果目标路径不在PATH里，需要手动添加：

Bash用户 #

编辑~/.bash_profile或~/.bashrc文件，添加一行：
export PATH="$PATH:/path/to/gh/directory"
将/path/to/gh/directory替换为实际的gh安装路径，然后执行source ~/.bash_profile使配置生效

Zsh用户 #

编辑~/.zshrc文件，添加同样的PATH配置行，然后执行source ~/.zshrc使配置生效

3. 验证并重新登录 #

完成安装或PATH配置后，执行gh --version，如果能显示版本号说明配置成功，再运行你的登录命令：
gh auth login -s 'user:email' -w

内容的提问来源于stack exchange，提问作者Max Briston