用途:通过 gh CLI 完成 GitHub 仓库的日常管理,覆盖仓库创建、复刻、分支、搜索与文件操作。
主要能力:创建公开或私有仓库(可加 README、克隆);将仓库复刻到个人账号或组织;从现有分支创建新分支;使用搜索语法按关键词、语言、星数、组织、主题搜索仓库;读取文件或目录内容;创建或更新文件;单次提交推送多个文件(推荐克隆后用 Git)。
使用方式:仓库创建如 gh repo create my-project --public --clone;复刻如 gh repo fork owner/repo-name --org my-org --clone;搜索如 gh search repos "web framework" --language python --stars ">1000";读取文件用 gh api repos/owner/repo-name/contents/path --jq '.content' | base64 -d;更新文件需先取 SHA 再 PUT。多文件改动建议克隆后使用 git add、git commit、git push。
适用场景:批量维护仓库、初始化项目、参与开源复刻后开发、在自动化流程中进行文件级操作。
限制:需先通过 gh auth status 确认认证,部分操作要求权限;更新文件必须提供原文件 SHA;多文件推送用 API 较复杂,官方建议直接使用 Git;创建已存在仓库或路径不存在时会报错,需要预先检查。