如何在 ZSH 提示符中动态条件显示 Git 分支与虚拟环境信息

日期：2026-01-01 00:00 / 作者：花韻仙語

本文详解如何通过自定义函数实现 zsh 提示符的条件渲染，仅在存在 git 仓库或激活虚拟环境时显示对应信息，并支持将二者合并显示于同一组方括号内，保持中性提示简洁无干扰。

ZSH 的 PROMPT 支持执行命令替换（$()），但需注意：普通 $() 在提示符中是「静态展开」的（即只在加载时执行一次），而要实现「每次显示前动态判断」，必须使用 %{...%} 包裹的 $(...) 形式，并确保函数返回值不含换行、控制字符，且高效轻量。

✅ 正确做法：编写动态提示函数

将 Git 分支与虚拟环境信息统一整合进一个函数，例如 prompt_vcs_info()：

prompt_vcs_info() {
  local git_part=""
  local venv_part=""

  # 检测 Git 仓库并获取当前分支
  if git rev-parse --git-dir >/dev/null 2>&1; then
    local branch=$(git symbolic-ref --short HEAD 2>/dev/null || git rev-parse --short HEAD 2>/dev/null)
    [[ -n "$branch" ]] && git_part="git:$branch"
  fi

  # 检测虚拟环境（兼容 venv/virtualenv/conda/poetry 等）
  if [[ -n "$VIRTUAL_ENV" ]]; then
    venv_part="env:${${VIRTUAL_ENV##*/}:-venv}"
  elif [[ -n "$CONDA_DEFAULT_ENV" && "$CONDA_DEFAULT_ENV" != "base" ]]; then
    venv_part="env:$CONDA_DEFAULT_ENV"
  elif [[ -n "$POETRY_ACTIVE" && -n "$POETRY_VIRTUAL_ENV" ]]; then
    venv_part="env:${${POETRY_VIRTUAL_ENV##*/}:-poetry}"
  fi

  # 合并显示：仅当至少一项存在时才渲染整个块
  if [[ -n "$git_part" || -n "$venv_part" ]]; then
    local sep=" "
    [[ -n "$git_part" && -n "$venv_part" ]] && sep=" "
    echo "%{$fg_bold[green]%}⟜[%{$reset_color%}%{$fg[white]%}${git_part}${sep}${venv_part}%{$reset_color%}%{$fg_bold[green]%}]⊸%{$reset_color%}"
  fi
}

✅ 关键点说明：使用 [[ -n "$var" ]] 判断非空，避免空格残留；${${VIRTUAL_ENV##*/}:-venv} 提取路径末尾名（如 /path/to/myenv → myenv），失败则回退为 venv；整个输出用 %{...%} 包裹，确保 ZSH 正确计算提示符宽度（避免光标错位）；函数返回为空字符串时，ZSH 自动忽略该段，不显示任何内容 —— 完美满足「中性提示无干扰」需求。

? 集成到 PROMPT

替换你原 PROMPT 中的 $(git_prompt_info) $(virtualenv_prompt_info) 部分：

PROMPT='%{$fg_bold[green]%}╭─[%{$reset_color%}%{$fg_bold[white]%}Swidenn %{$reset_color%}%{$fg_bold[green]%}⚡%{$reset_color%}%{$fg_bold[white]%}%M%{$reset_color%}%{$fg_bold[green]%}]%{$reset_color%}$(prompt_vcs_info)%{$fg_bold[green]%}▷ %{$reset_color%}%{$fg[white]%}%~
%{$reset_color%}%{$fg_bold[green]%}╰─[%{$reset_color%}%{$fg[white]%}%!%{$reset_color%}%{$fg_bold[green]%}]-> '

⚠️ 注意事项：

不要在函数中调用耗时命令（如 git status），否则会导致每次按键卡顿；上述方案仅用 git rev-parse 和 symbolic-ref，毫秒级响应；
若你使用的是 oh-my-zsh，建议禁用其内置 git 和 virtualenv 插件（注释掉 .zshrc 中的 plugins=(... git virtualenv)），避免冲突；
所有颜色变量（如 %{$fg_bold[green]%}）需确保已在 .zshrc 中定义（通常 autoload -U colors && colors 即可）。

? 进阶推荐：Starship（零配置替代方案）

若追求更高稳定性与跨 Shell 兼容性，Starship 是现代终端提示符的行业标准：

自动检测 Git 状态、虚拟环境、Node.js 版本、Kubernetes 上下文等数十种上下文；
配置通过 TOML 文件声明式定义，支持合并显示（如 [git:main env:py311]）；
无 shell 函数性能负担，Rust 编写，启动与渲染极快。

只需三步启用：

curl -sS https://www./link/7f876c8429a1389bbfbf9c70b0e6e826/install.sh | sh
echo 'eval "$(starship init zsh)"' >> ~/.zshrc
starship configure  # 按需调整模块顺序与格式

总结：ZSH 提示符的条件逻辑应封装在轻量函数中，利用 $(...) 动态插值，并严格处理空值与转义；对复杂场景，Starship 是更健壮、可维护的长期选择。