github cli 无直接下载 zip 命令，但可通过三种方式获取项目：一、gh repo clone owner/repo 克隆完整仓库；二、gh api 调用 api 获取 zip 包链接并用 curl 下载；三、gh repo view 查信息后 git clone --depth 1 快速拉取单分支快照。
如果您希望使用 GitHub 命令行工具（GitHub CLI，即 gh）下载项目代码，而非通过网页界面或直接使用 git clone，则需明确：GitHub CLI 本身不提供独立的“下载 ZIP”或“导出源码包”命令，但可通过调用底层 Git 或与 GitHub API 交互实现项目获取。以下是几种可行的操作方式：
一、使用 gh repo clone 下载远程仓库到本地
该命令基于 Git 协议克隆仓库，是 GitHub CLI 提供的最直接等效于“下载项目”的操作，会拉取完整历史记录和所有分支。
1、确保已安装 GitHub CLI 并完成身份验证：gh auth login，按提示选择 GitHub.com 和登录方式。
2、执行克隆命令，格式为：gh repo clone <owner>/<repo-name></repo-name></owner>，例如：gh repo clone facebook/react。
3、命令将自动创建同名子目录，并在其中完成 Git 克隆；默认使用 HTTPS 协议，若需 SSH，请先配置 SSH 密钥并运行 gh config set git_protocol ssh。
二、使用 gh api 调用 GitHub REST API 获取 ZIP 包
此方法模拟网页端“Code → Download ZIP”行为，直接获取无 Git 历史的压缩包，适用于仅需源码文件、无需版本控制的场景。
1、构造 API 请求，获取仓库默认分支的 ZIP 归档链接：gh api -H "Accept: application/vnd.github+json" /repos/{owner}/{repo}/zipball --jq '.zipball_url'。
2、使用 curl 下载该 URL 返回的重定向后的真实 ZIP 地址，例如：curl -L $(gh api -H "Accept: application/vnd.github+json" /repos/torvalds/linux/zipball --jq '.zipball_url') -o linux.zip。
3、解压 ZIP 文件：unzip linux.zip；解压后顶层目录名含提交 SHA，建议重命名以便识别。
三、结合 gh repo view 获取仓库信息后手动 git clone
当不确定仓库名称或需要确认默认分支、可见性等元数据时，可先查询再执行标准 Git 操作。
1、运行 gh repo view <owner>/<repo-name> --web</repo-name></owner> 查看网页版页面，或省略 --web 以终端形式显示关键字段。
2、从输出中确认 Clone URL 字段（如 https://github.com/owner/repo.git）及默认分支名（如 main 或 master）。
3、使用原生 git 命令下载指定分支的最新快照：git clone --depth 1 --branch main https://github.com/owner/repo.git；添加 --depth 1 可显著减少下载体积和时间。
