企业官网建设流程全解析

GitHub CLI 如何用 gh label clone 把一个仓库的 labels 复制到另一个仓库？

【免费下载链接】cliGitHub’s official command line tool项目地址: https://gitcode.com/GitHub_Trending/cli/cli

当你接手一个新仓库，需要把它和团队现有仓库保持同一套 issue 标签（bug、docs 等）时，可以不用逐个手动创建。GitHub CLI 提供了gh label clone命令，把源仓库的全部 labels 复制到一个目标仓库。命令执行完成后，源仓库中的每个 label 的名称、描述和颜色都会出现在目标仓库中；已经存在的 label 默认会被跳过，也可以用--force覆盖。

命令行为以源码 clone.go 中的帮助文本为准，先明确三条规则，避免对结果产生误解：

• 默认情况下，目标仓库是当前仓库（即执行命令时所在的 git 仓库所对应的仓库）；
• 源仓库的全部 labels 都会被复制到目标仓库；
• 目标仓库中已存在、但源仓库中不存在的 labels不会被删除或修改；源仓库中已存在的 labels 默认跳过，加--force才会覆盖其颜色和描述。

准备条件

• 已安装 GitHub CLI 并完成登录（gh label下的所有子命令都需要认证会话，认证子命令位于 auth 命令组）。
• 源仓库使用OWNER/REPO格式指定，这个仓库只被读取，不会被修改。

执行复制

基本用法是：

gh label clone <source-repository>

其中<source-repository>是必填的位置参数，格式为OWNER/REPO。不带任何其他 flag 时，labels 会被复制到当前仓库。缺少该参数会直接报错：

cannot clone labels: source-repository argument required

如果目标不是当前仓库，用-R, --repo指定。这个 flag 是gh label命令组级的持久化 flag（实现在 repo_override.go），格式为[HOST/]OWNER/REPO，也可以改用环境变量GH_REPO达到同样效果。命令自带的示例：

# Clone and overwrite labels from cli/cli repository into the current repository $ gh label clone cli/cli --force # Clone labels from cli/cli repository into octocat/cli repository $ gh label clone cli/cli --repo octocat/cli

第一条是复制进当前仓库并用--force覆盖已存在的 labels；第二条是把cli/cli的 labels 复制进octocat/cli这个显式指定的目标仓库。两条命令都可以直接替换仓库名后执行。

--force（简写-f）是唯一的行为开关，帮助文本为 "Overwrite labels in the destination repository"。不加它时，同名 label 在目标仓库中保持原样，只创建目标仓库中还没有的 labels；加它时，已存在的 labels 会用源仓库的颜色和描述更新（底层对已存在项走PATCH更新，见 create.go 中的updateLabel）。

验证复制结果

命令在 TTY 下会输出一行汇总，成功时是✓开头、部分跳过时是!开头。以下是仓库测试 clone_test.go 中记录的输出示例（测试用例的示例结果，具体数字取决于源仓库实际有多少 labels）：

✓ Cloned 2 labels from cli/cli to OWNER/REPO ! Cloned 1 label of 2 from cli/cli to OWNER/REPO

第二行表示 2 个中有 1 个因已存在被跳过。想进一步核对，可以在目标仓库里运行gh label list查看名称、描述和颜色三列：

gh label list --repo octocat/cli

gh label list的表格列固定为 NAME、DESCRIPTION、COLOR（见 list.go），与 clone 复制的字段一致。注意gh label list默认每页最多取 30 条（--limit默认值为 30），labels 很多时要加大--limit才能看全。

常见问题与边界

• 源仓库解析失败：源仓库名写错或仓库不存在时，命令会报 GraphQL 错误，测试中记录的示例为GraphQL: Could not resolve to a Repository with the name 'cli/invalid'. (repository)。这发生在拉取标签列表阶段，尚未对目标仓库做任何修改。
• 创建被 GitHub 拒绝：个别 label 创建失败（测试中记录的示例为HTTP 422: Validation Failed ... Label.color is invalid）时命令会整体报错退出，已创建的部分会保留在目标仓库中，可结合gh label list确认进度后重跑。
• --force不等于全量同步：加--force也只是用源仓库的值更新同名 labels，目标仓库独有的 labels 依旧保留，不会被删除。若需要"两边完全一致"，clone 之后还要自行用gh label delete清理多余项，命令本身不提供这个能力。

完成复制后，目标仓库即拥有与源仓库一致的这套 labels；后续新增或调整可以继续使用gh label create、gh label edit等同一命令组的子命令维护。

【免费下载链接】cliGitHub’s official command line tool项目地址: https://gitcode.com/GitHub_Trending/cli/cli