本文详解如何通过自定义函数实现 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]%}]-> '⚠️ 注意事项：
Evez Github Manager
下载
在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。
- 不要在函数中调用耗时命令（如 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 是更健壮、可维护的长期选择。
