gh repo fork

gh repo fork [<repository>] [-- <gitflags>...] [flags]

创建仓库的分支。

不带任何参数时,会为当前仓库创建分支。否则,会为指定的仓库创建分支。

默认情况下,新的分支会设置为你的 origin 远程仓库,而任何现有的 origin 远程仓库都会被重命名为 upstream。要更改此行为,可以使用 --remote-name 设置新的分支远程仓库的名称。

upstream 远程仓库将被设置为默认的远程仓库。

额外的 git clone 标记可以在 -- 之后传递。

选项

--clone
克隆分支
--default-branch-only
仅将默认分支包含在分支中
--fork-name <string>
重命名分支的仓库
--org <string>
在组织中创建分支
--remote
为分支添加一个 git 远程仓库
--remote-name <string> (默认 "origin")
指定新远程仓库的名称

另请参阅

使用方式

不带任何参数

在 git 仓库内,不带任何参数,我们将自动在 GitHub 上为你的帐户创建你当前目录的分支。然后会提示你是否要设置 upstream 远程仓库。

# Create a fork for the current repository.
~/Projects/cli$ gh repo fork
- Forking cli/cli...
 Created fork user/cli
? Would you like to add a remote for the fork? Yes
 Renamed origin remote to upstream
 Added remote origin
~/Projects/cli$

带参数

如果你传递一个 OWNER/REPO 格式的仓库,`gh` 将自动在 GitHub 上为你的帐户创建分支,并询问你是否要克隆它。这可以在 git 仓库内或外部进行。

# Create a fork for another repository.
~/Projects$ gh repo fork cli/cli
- Forking cli/cli...
 Created fork cli/cli
? Would you like to clone the fork? Yes
Cloning into 'cli'...
 Cloned fork
~/Projects$ cd cli
~/Projects/cli$

使用标记

使用标记跳过有关为分支添加 git 远程仓库或在本地克隆分支的提示。

# Skipping remote prompts using flags
~/Projects/cli$ gh repo fork --remote=false
- Forking cli/cli...
 Created fork user/cli
~/Projects/cli$
# Skipping clone prompts using flags
~/Projects$ gh repo fork cli/cli --clone=false
- Forking cli/cli...
 Created fork user/cli
~/Projects$