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

本文详解如何通过自定义函数实现 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.php.cn/link/7f876c8429a1389bbfbf9c70b0e6e826/install.sh | sh echo 'eval "$(starship init zsh)"' >> ~/.zshrc starship configure  # 按需调整模块顺序与格式

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