通过GitHub CLI执行gh repo clone克隆仓库返回用法错误
问题现象
按照GitHub仓库页指引使用gh repo clone命令克隆代码仓库,对应操作指引截图:
执行命令gh repo clone https://github.com/xardox69/android_EPG时返回如下报错:
usage: gh [-h] [--home] [-p] [-b] [-s] [-r] [-t] [-c] [-w] [-i] [-d] [-v]
gh: error: unrecognized arguments: repo clone https://github.com/xardox69/android_EPG
错误原因
本地环境里的gh命令不是官方发布的GitHub CLI工具,是一个仅支持终端快速跳转GitHub页面的第三方同名小工具。
从报错输出的参数列表就能看出来,这个工具的所有参数都是页面跳转相关开关,没有子命令扩展能力,根本不支持repo clone这类仓库操作指令,所以直接报无法识别参数的错误。
修复步骤
- 先移除冲突的第三方gh程序:终端执行
which gh查看当前gh命令的文件存储路径,直接删除对应二进制文件即可;如果是通过brew、apt这类包管理器安装的第三方版本,直接用对应包管理器的卸载命令移除即可。 - 安装官方GitHub CLI:
- macOS(Homebrew环境):执行
brew install gh - Windows(Winget环境):执行
winget install --id GitHub.cli - Debian/Ubuntu 系:先添加GitHub官方软件源,再执行
sudo apt install gh
- macOS(Homebrew环境):执行
- 安装完成后关闭当前终端重新打开,执行
gh auth login按照交互提示完成GitHub账号认证。 - 认证完成后即可正常执行克隆命令,两种写法均支持:
- 短格式(官方推荐,不易出现格式错误):
gh repo clone xardox69/android_EPG - 完整HTTPS链接格式:
gh repo clone https://github.com/xardox69/android_EPG
- 短格式(官方推荐,不易出现格式错误):
内容的提问来源于stack exchange,提问作者ozmank
相关产品推荐
相关产品推荐

