如何在命令行仅快速切换Git本地分支？

一、仅针对本地分支的快捷切换配置 #

1. 自定义别名简化本地分支切换 #

如果不想调整补全规则，可以直接创建别名，仅基于本地分支列表操作：

# 在~/.zshrc中添加以下别名
alias gswl='git switch $(git branch --format="%(refname:short)")'

调用时输入gswl后，手动补充分支名前缀即可（Git会自动匹配符合前缀的本地分支）。

2. 修改zsh补全，让git switch仅补全本地分支 #

希望保留git switch的补全功能，但只显示本地分支的话，可修改zsh补全规则：
在~/.zshrc中添加以下代码：

# 定义仅补全本地分支的git switch补全函数
_git_switch_local() {
  local expl
  declare -a branch_names
  # 仅获取本地分支（排除HEAD）
  branch_names=(${${(f)"$(git for-each-ref --format='%(refname:short)' refs/heads)"}:#HEAD})
  _wanted branch-names expl branch name compadd $* - $branch_names
}

# 将补全函数绑定到git switch-local命令
compdef _git_switch_local git switch-local

# 创建别名简化调用
alias gsw='git switch-local'

之后执行gsw <tab>，只会补全本地分支，不会出现远程分支干扰。

二、交互式选择分支的命令行方案 #

1. Shell内置select命令（无需额外安装） #

利用Shell自带的select功能，直接列出所有本地分支，通过输入序号切换：

# 在~/.zshrc中添加别名
alias gsw='select branch in $(git branch --format="%(refname:short)"); do git switch $branch; break; done'

输入gsw后，终端会列出所有本地分支并显示序号，输入对应序号即可完成切换。

2. 用fzf实现模糊搜索+提交预览（推荐） #

fzf是轻量命令行模糊搜索工具，支持箭头选择、实时预览，安装后可大幅提升效率：

# 在~/.zshrc中添加别名
alias gsw='git branch --format="%(refname:short) %(subject)" | fzf --delimiter=" " --nth=1 --preview="git log -1 --oneline {1}" | awk "{print \$1}" | xargs git switch'

该别名的功能：

• 列出所有本地分支及对应提交标题
• 支持模糊搜索分支名
• 选中分支时可预览该分支最后一条提交记录
• 按回车直接切换到选中分支

三、临时快速切换小技巧 #

如果分支名有明确前缀，可直接输入前缀让Git自动匹配：

git switch feature/user

Git会自动匹配最接近的本地分支（无歧义时直接切换）。

内容的提问来源于stack exchange，提问作者Nathan Long