Oh My Zsh Mercurial 插件完全指南别名、提示符函数与主题集成【免费下载链接】ohmyzsh A delightful community-driven (with 2,500 contributors) framework for managing your zsh configuration. Includes 300 optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python, etc), 140 themes to spice up your morning, and an auto-update tool that makes it easy to keep up with the latest updates from the community.项目地址: https://gitcode.com/gh_mirrors/oh/ohmyzsh导读Mercurialhg是主流的分布式版本控制系统之一在 Python、Mozilla 等生态中被广泛使用。Oh My Zsh 的 mercurial 插件 为日常hg操作提供了一组精简、易记的别名并内置了可供主题直接调用的提示符函数prompt functions让你能在 Zsh 提示符中实时看到当前仓库的分支名与工作区脏状态dirty/clean。读完本文你将掌握该插件的全部别名用法、如何让任意主题显示 Mercurial 仓库状态以及这些提示符函数在源码层面的实现原理从而在 Git 与 Mercurial 混合开发环境中获得一致的命令行体验。启用插件与 Oh My Zsh 的所有插件一样只需编辑~/.zshrc在plugins数组中追加mercurialplugins(... mercurial)之后重新加载配置source ~/.zshrc或新开终端即可生效。插件主体只有一个文件 mercurial.plugin.zsh它同时定义了别名aliases与提示符辅助函数functions两部分内容。别名总览插件为 Mercurial 提供了 20 个高频命令别名覆盖了从提交、分支到日志、拉取推送的完整工作流AliasCommandhgahg addhgchg commithgcahg commit --amendhgcihg commit --interactivehgbhg branchhgbahg brancheshgbkhg bookmarkshgcohg checkouthgdhg diffhgedhg diffmergehgphg pushhgshg statushgslhg log --limit 20 --template templatehgunhg resolve --listhgihg incominghglhg pull -uhglrhg pull --rebasehgohg outgoinghglghg log --stat -vhglgphg log --stat -p -v别名背后的具体实现对照 mercurial.plugin.zsh 源码可以看到别名中最值得关注的是hgsl它并非简单的hg log而是带模板的紧凑输出alias hgslhg log --limit 20 --template {node|short} | {date|isodatesec} | {author|person}: {desc|strip|firstline}\n 模板从左到右依次输出短哈希node|short、ISO 格式时间戳date|isodatesec、作者人名author|person以及经过 strip/firstline 清洗的提交描述每条记录占一行非常适合快速扫读最近 20 条提交。同时hglg与hglgp都追加了-vverbose参数前者输出带文件统计的日志--stat后者再叠加-p直接展示每个变更的完整 diff。注意源码中hglgp实际写作hg log --stat -p -v两个空格不影响功能。附带的计数函数除了别名插件还额外定义了两个未被 README 收录、但在脚本和提示符中很有用的计数函数function hgic() { hg incoming $ | grep changeset | wc -l } function hgoc() { hg outgoing $ | grep changeset | wc -l }hgic/hgoc分别统计hg incoming本仓库尚未拉取的远端变更集与hg outgoing本地尚未推送的变更集的数量。它们会透传$参数因此可以像hgic -r rev一样按指定版本范围统计。incoming/outgoing需要与远端交互网络不可用时命令会失败此时hg的输出中不含 changeset 行计数结果为 0。提示符函数Prompt Functions插件为提示符场景准备了四个核心函数职责各不相同hg_root向上查找仓库根目录function hg_root() { local dir$PWD while [[ $dir ! / ]]; do if [[ -d $dir/.hg ]]; then echo $dir return 0 fi dir${dir:h} done return 1 }hg_root从当前目录出发逐级向上通过dir:h取父目录寻找包含.hg元数据目录的仓库根若一直追溯到/仍未命中则返回 1。它本质上等价于hg root但完全在 shell 内完成、不依赖外部命令。in_hg / hg_get_branch_name / hg_get_bookmark_namefunction in_hg() { hg_root /dev/null } function hg_get_branch_name() { local dir if ! dir$(hg_root); then return fi if [[ ! -f $dir/.hg/branch ]]; then echo default return fi echo $($dir/.hg/branch) } function hg_get_bookmark_name() { local dir if ! dir$(hg_root); then return fi if [[ ! -f $dir/.hg/bookmarks.current ]]; then return fi echo $($dir/.hg/bookmarks.current) }in_hg判断当前目录含上级目录是否位于某个 Mercurial 仓库内可作为条件判断使用hg_get_branch_name直接读取.hg/branch文件获取当前分支名文件不存在时即仓库未显式创建分支时回退输出default——这与 Mercurial 的默认分支名一致hg_get_bookmark_name读取.hg/bookmarks.current输出当前激活的书签bookmark名未设置书签时静默返回。值得强调的是这两个函数采用“读文件而非执行hg branch命令”的实现策略意味着它们开销极小、无需等待进程启动非常适合高频调用的提示符场景。hg_prompt_info提示符核心入口function hg_prompt_info { local dir branch dirty if ! dir$(hg_root); then return fi if [[ ! -f $dir/.hg/branch ]]; then branchdefault else branch$($dir/.hg/branch) fi dirty$(hg_dirty) echo ${ZSH_THEME_HG_PROMPT_PREFIX}${branch:gs/%/%%}${dirty}${ZSH_THEME_HG_PROMPT_SUFFIX} }hg_prompt_info的组合逻辑是前缀 分支名 脏状态 后缀。其中${branch:gs/%/%%}会把分支名中的%转义为%%避免分支名中的百分号被 Zsh 的 PROMPT_SUBST 展开机制误解析——这与 lib/git.zsh 中git_prompt_info对引用名所做的%转义处理如出一辙。hg_dirty工作区脏状态检测function hg_dirty { # Do nothing if clean / dirty settings arent defined if [[ -z $ZSH_THEME_HG_PROMPT_DIRTY -z $ZSH_THEME_HG_PROMPT_CLEAN ]]; then return fi # Check if there are modifications local hg_status if [[ $DISABLE_UNTRACKED_FILES_DIRTY true ]]; then if ! hg_status$(hg status -q 2/dev/null); then return fi else if ! hg_status$(hg status 2/dev/null); then return fi fi # grep exits with 0 when dirty if command grep -Eq ^\s*[ACDIMR!?L].*$ $hg_status; then echo $ZSH_THEME_HG_PROMPT_DIRTY return fi echo $ZSH_THEME_HG_PROMPT_CLEAN }hg_dirty的实现要点有三开关保护若ZSH_THEME_HG_PROMPT_DIRTY与ZSH_THEME_HG_PROMPT_CLEAN都未定义函数直接返回避免在主题未配置时输出空噪声未跟踪文件开关DISABLE_UNTRACKED_FILES_DIRTYtrue时改用hg status -qquiet 模式不带未跟踪文件状态行这为包含大量未跟踪文件的大型仓库提供了性能优化途径。这一开关的命名与语义和 Git 插件的DISABLE_UNTRACKED_FILES_DIRTY见 lib/git.zsh保持了一致状态判定正则^\s*[ACDIMR!?L].*$匹配hg status输出的各类变更状态行——A(added)、C(clean/copied)、D(deleted)、I(ignored)、M(modified)、R(removed)、!(missing)、?(untracked)、L(copy) 等。只要匹配到任意一行即判定为 dirty输出$ZSH_THEME_HG_PROMPT_DIRTY否则输出$ZSH_THEME_HG_PROMPT_CLEAN。在提示符中显示仓库状态方式一直接使用内置支持的主题插件提示符的官方用法是“切换到使用hg_prompt_info的主题”。在仓库的 themes 目录中已有多个主题原生集成了hg_prompt_infoaf-magic.zsh-theme%~$(git_prompt_info)$(hg_prompt_info) ...Git 与 hg 状态并排显示afowler.zsh-theme$(hg_prompt_info)$(git_prompt_info)bira.zsh-themelocal vcs_branch$(git_prompt_info)$(hg_prompt_info)norm.zsh-theme$(git_prompt_info)$(hg_prompt_info)且定义了ZSH_THEME_HG_PROMPT_PREFIXλ %{$fg[blue]%}hg %{$fg[red]%}、ZSH_THEME_HG_PROMPT_SUFFIX%{$fg[yellow]%} → %{$reset_color%}展示出 hg 状态可被主题自由配色的典型做法candy-kingdom.zsh-theme若检测到hg promptMercurial 的 prompt 扩展可用则用其输出分支、标签、修改状态与补丁队列否则退化为空函数rkj-repos.zsh-theme 与 gallois.zsh-theme 则各自重写了hg_prompt_info的定制版本。选择此类主题后进入任意 Mercurial 仓库目录即可看到分支与脏状态提示。方式二手动修改当前主题的 $PROMPT如果仍想保留当前主题可以在~/.zshrc中主题加载之后自定义$PROMPT变量。README 以robbyrussell主题为例在$(git_prompt_info)之后追加$(hg_prompt_info)PROMPT${ret_status}%{$fg_bold[green]%}%p %{$fg[cyan]%}%c %{$fg_bold[blue]%}$(git_prompt_info)$(hg_prompt_info)%{$fg_bold[blue]%} % %{$reset_color%}这样 Git 仓库显示 Git 分支信息、Mercurial 仓库显示 hg 分支信息两者互不干扰。更稳妥的做法是把主题文件复制一份放到$ZSH_CUSTOM/themes/下进行定制再在~/.zshrc中设置ZSH_THEME自定义主题名这样升级 Oh My Zsh 时不会覆盖你的改动。定制提示符外观变量插件默认将 hg 状态的输出格式完全交给以下四个变量你可以在 Oh My Zsh 加载完成后即~/.zshrc中重新定义它们ZSH_THEME_HG_PROMPT_PREFIX%{$fg_bold[magenta]%}hg:(%{$fg[red]%} ZSH_THEME_HG_PROMPT_SUFFIX%{$reset_color%} ZSH_THEME_HG_PROMPT_DIRTY%{$fg[magenta]%}) %{$fg[yellow]%}✗%{$reset_color%} ZSH_THEME_HG_PROMPT_CLEAN%{$fg[magenta]%})ZSH_THEME_HG_PROMPT_PREFIX分支名之前的前缀默认为粉紫色hg:( 红色ZSH_THEME_HG_PROMPT_SUFFIX整段状态之后的后缀默认重置颜色ZSH_THEME_HG_PROMPT_DIRTY工作区有变更时追加的输出示例中为黄色✗标记ZSH_THEME_HG_PROMPT_CLEAN工作区干净时的输出示例中仅为闭合括号)。由于hg_prompt_info与hg_dirty会严格按这些变量的存在与否来决定行为见上文hg_dirty的开关保护因此至少应定义ZSH_THEME_HG_PROMPT_PREFIX与ZSH_THEME_HG_PROMPT_SUFFIX并按需定义 DIRTY/CLEAN 两个状态标记否则脏状态部分不会渲染任何内容。提示这些变量名与 Git 插件的ZSH_THEME_GIT_PROMPT_PREFIX系列一一对应对照 norm.zsh-theme 中对两套变量的成对定义在 Git/hg 双环境主题中可按相同风格统一设计。函数级兜底机制如果主题引用了hg_prompt_info但用户并未启用 mercurial 插件函数将无法解析。Oh My Zsh 通过 lib/prompt_info_functions.zsh 提供了统一兜底hg_prompt_info与chruby_prompt_info、rbenv_prompt_info等一起被定义为返回 1 的“哑实现”dummy implementation防止主题在未加载插件时报 command_not_found 错误一旦插件被加载真实的hg_prompt_info会覆盖该占位实现。与 Git 插件的对应关系与注意事项并列共存Mercurial 插件的提示符函数与 Git 插件的git_prompt_info见 lib/git.zsh设计完全对标二者可同时出现在$PROMPT中。由于hg_root只认.hg目录在 Git 仓库中调用hg_prompt_info会静默返回反之亦然因此两种仓库类型下均不会输出错误信息。执行成本hg_dirty每次提示符渲染都会启动一次hg status进程在大型仓库或网络挂载盘上若感觉提示符变慢可设置DISABLE_UNTRACKED_FILES_DIRTYtrue切换为hg status -q以跳过未跟踪文件扫描。依赖前置插件的别名与函数都依赖系统已安装 Mercurialhg命令。若本机尚无 hg可先通过系统包管理器如apt install mercurial、brew install mercurial安装后再启用本插件。适用边界hgsl的模板语法依赖 Mercurial 的 template 关键字如isodatesec、person请使用较新版本的 Mercurial旧版本若报模板关键字错误可改用hglg查看日志。快速验证清单在~/.zshrc的plugins(...)中加入mercurial并重载配置进入任意 hg 仓库输入hgs、hgc、hgsl验证别名生效在提示符中执行hg_prompt_info应能看到形如hg:(default)的输出修改一个文件后再次执行若已配置 DIRTY 变量输出应出现脏状态标记如 ✗确认 Git 仓库中hg_prompt_info静默返回、hq 仓库中git_prompt_info静默返回两种提示符互不串扰。至此你已掌握 mercurial 插件从别名到提示符定制的完整用法并理解了hg_root、hg_dirty等函数“读元数据文件 正则匹配状态行”的精简实现思路——这正是该插件在保持强大功能的同时依然轻量高效的秘诀。【免费下载链接】ohmyzsh A delightful community-driven (with 2,500 contributors) framework for managing your zsh configuration. Includes 300 optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python, etc), 140 themes to spice up your morning, and an auto-update tool that makes it easy to keep up with the latest updates from the community.项目地址: https://gitcode.com/gh_mirrors/oh/ohmyzsh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考