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$