如何修改 Powerlevel10k 的 my_git_formatter 函数自定义 Git 状态格式【免费下载链接】powerlevel10kA Zsh theme项目地址: https://gitcode.com/GitHub_Trending/po/powerlevel10kPowerlevel10k 是一个 Zsh 主题它的 prompt 会显示当前 Git 仓库的状态分支、tag、ahead/behind 提交数、staged/unstaged/untracked 文件数等。如果你想在 prompt 中改变 Git 状态的显示格式——比如换掉截断规则、去掉某个计数、调整颜色或拼接顺序——官方给出的做法是打开~/.p10k.zsh搜索my_git_formatter直接编辑这个函数的源码见 README 的 FAQ How do I change the format of Git status?。前提你的~/.p10k.zsh由p10k configure配置向导生成并且使用的风格包含my_git_formatter函数。Lean、Classic、Rainbow 风格都包含它robbyrussell 风格包含一个更精简的变体Pure 风格不使用该函数。仓库内的 config/p10k-rainbow.zsh、config/p10k-classic.zsh 等配置文件展示了向导会生成的函数原貌可以直接对照查看。在~/.p10k.zsh中定位函数在 Zsh 会话中打开配置文件并搜索函数名# 以 zsh 打开你自己的配置文件不在本仓库内 ${EDITOR:-vi} ~/.p10k.zsh # 在编辑器中搜索: my_git_formatter你会看到函数定义以及紧随其后的三行关键参数以 Rainbow 风格为例function my_git_formatter() { ... } functions -M my_git_formatter 2/dev/null # Disable the default Git status formatting. typeset -g POWERLEVEL9K_VCS_DISABLE_GITSTATUS_FORMATTINGtrue # Install our own Git status formatter. typeset -g POWERLEVEL9K_VCS_CONTENT_EXPANSION${$((my_git_formatter()))${my_git_format}}这几行说明函数是如何生效的POWERLEVEL9K_VCS_DISABLE_GITSTATUS_FORMATTINGtrue关闭 gitstatus 插件的默认 Git 状态格式POWERLEVEL9K_VCS_CONTENT_EXPANSION让 prompt 通过数学表达式$((my_git_formatter()))调用函数然后把全局变量my_git_format的内容渲染到 prompt 的vcs段函数末尾必须把结果写回typeset -g my_git_format$res否则 prompt 拿不到任何内容。因此你只需要改函数体不需要动这三行参数robbyrussell 变体还会额外定义POWERLEVEL9K_VCS_LOADING_CONTENT_EXPANSION用于加载中的灰色状态。理解函数结构再动手以 config/p10k-rainbow.zsh 中的完整版本为例函数可以分成四部分加载态短路P9K_CONTENT非空时状态还在加载或数据来自 vcs_info 而非 gitstatus 插件直接输出$P9K_CONTENT并 return。此时VCS_STATUS_*参数不可用所以这段逻辑要保留。样式变量meta/clean/modified/untracked/conflicted五个局部变量存放 ANSI 颜色码如local clean%0F。Classic 风格下这些变量按参数$1区分最新状态和加载中状态两套颜色。逐段拼接函数依次检查VCS_STATUS_LOCAL_BRANCH、VCS_STATUS_TAG、VCS_STATUS_COMMIT、VCS_STATUS_REMOTE_BRANCH、VCS_STATUS_COMMIT_SUMMARY、ahead/behind、push ahead/behind、stashes、VCS_STATUS_ACTION、冲突数、staged 数、unstaged 数、untracked 数等参数向res追加对应片段。这些VCS_STATUS_*参数由 gitstatus 插件设置函数注释中注明了这一点。写回全局变量typeset -g my_git_format$res。代码里的注释已经标出了常见自定义点例如(( $#branch 32 )) branch[13,-13]…分支名超过 32 个字符时只保留前 12 和后 12 个字符。注释提示若想完整显示不截断删除这一行。 -z $VCS_STATUS_LOCAL_BRANCH # -- this linetag 只在不在分支上时才显示删除该行可让 tag 始终显示。[[ -z $VCS_STATUS_LOCAL_BRANCH -z $VCS_STATUS_TAG ]] # -- this line控制无分支且无 tag 时显示当前 commit 前 8 位的触发条件。# res ${clean}取消注释后与远端一致既不 ahead 也不 behind时会显示。未跟踪文件的?42计数来自一行独立判断注释明确说不想看 untracked 文件就删除下一行。这些VCS_STATUS_*参数各自对应哪些 prompt 符号README 的 What do different symbols in Git status mean? 给出了对照表feature:master wip ⇣42⇡42 ⇠42⇢42 *42 merge ~42 42 !42 ?42符号含义来源命令feature当前分支不在分支上时替换为#tag或commitgit status --ignore-submodulesdirtymaster远端跟踪分支仅在与本地分支不同时显示git rev-parse --abbrev-ref --symbolic-full-name {upstream}wip最新 commit 摘要包含 wip 或 WIPgit show --pretty%s --no-patch HEAD与远端一致git rev-list --count HEAD...{upstream}⇣42落后远端 42 个提交git rev-list --right-only --count HEAD...{upstream}⇡42领先远端 42 个提交git rev-list --left-only --count HEAD...{upstream}⇠42/⇢42落后 / 领先 push 远端的提交数git rev-list ... {push}*42stash 数量git stash listmerge仓库处于特殊状态如合并中git status --ignore-submodulesdirty~4242 个合并冲突git status --ignore-submodulesdirty4242 个 staged 变更git status --ignore-submodulesdirty!4242 个 unstaged 变更git status --ignore-submodulesdirty?4242 个未跟踪文件git status --ignore-submodulesdirty─staged/unstaged/untracked 数量未知由POWERLEVEL9K_VCS_MAX_INDEX_SIZE_DIRTY或仓库的bash.showDirtyState引起上表中的42是文档示例值表示数量占位不是固定输出。一个完整的修改示例假设你要分支名永不截断、与远端一致时显示、完全不显示 untracked 文件。在~/.p10k.zsh的my_git_formatter中做三处编辑下面摘出对应片段省略号部分保持原样function my_git_formatter() { emulate -L zsh if [[ -n $P9K_CONTENT ]]; then typeset -g my_git_format$P9K_CONTENT return fi # ...meta/clean/modified/untracked/conflicted 颜色变量与 local res 保持原样... if [[ -n $VCS_STATUS_LOCAL_BRANCH ]]; then local branch${(V)VCS_STATUS_LOCAL_BRANCH} # 修改 1: 删除下一行分支名不再截断 # (( $#branch 32 )) branch[13,-13]… res${clean}${(g::)POWERLEVEL9K_VCS_BRANCH_ICON}${branch//\%/%%} fi # ...tag、commit、remote branch、wip 段落保持原样... if (( VCS_STATUS_COMMITS_AHEAD || VCS_STATUS_COMMITS_BEHIND )); then (( VCS_STATUS_COMMITS_BEHIND )) res ${clean}⇣${VCS_STATUS_COMMITS_BEHIND} (( VCS_STATUS_COMMITS_AHEAD !VCS_STATUS_COMMITS_BEHIND )) res (( VCS_STATUS_COMMITS_AHEAD )) res${clean}⇡${VCS_STATUS_COMMITS_AHEAD} elif [[ -n $VCS_STATUS_REMOTE_BRANCH ]]; then # 修改 2: 取消注释与远端一致时显示 res ${clean} fi # ...push ahead/behind、stashes、action、conflicted、staged、unstaged 段落保持原样... # 修改 3: 删除 untracked 文件的输出行 # (( VCS_STATUS_NUM_UNTRACKED )) res ${untracked}${(g::)POWERLEVEL9K_VCS_UNTRACKED_ICON}${VCS_STATUS_NUM_UNTRACKED} # ─ 未知状态行保持原样 (( VCS_STATUS_HAS_UNSTAGED -1 )) res ${modified}─ typeset -g my_git_format$res }改动的原则是只调整你要的片段其余拼接逻辑包括P9K_CONTENT短路和typeset -g my_git_format$res保持不动因为加载态 prompt 和POWERLEVEL9K_VCS_CONTENT_EXPANSION都依赖它们。应用并验证修改保存后在当前 Zsh 会话中应用README 给出的做法source ~/.p10k.zsh然后进入任意 Git 仓库对照上面的符号表观察 prompt 的vcs段。README 的性能一节的表格里给出了一组可复现的状态变化与对应 prompt 指示示例输出执行的命令prompt 指示含义touch x y?2当前仓库有 2 个未跟踪文件rm COPYING!1当前仓库有 1 个 unstaged 变更以默认配置为准做验证在某个测试仓库中执行touch x y后下一次 prompt 应出现?2如果你按上例删除了 untracked 输出行?2不应再出现而rm COPYING产生的!1应继续显示——这同时说明你的删除只影响了 untracked 段没有破坏其他拼接逻辑。限制与注意事项函数里的VCS_STATUS_*参数由 gitstatus 插件提供当P9K_CONTENT非空状态加载中或数据来自 vcs_info时这些参数不可用函数开头的短路逻辑不能删除。状态未及时计算完时Git 状态会先以灰色Rainbow 风格下为灰底黑字显示上次结果后台计算完成后自动刷新为彩色这是POWERLEVEL9K_VCS_MAX_SYNC_LATENCY_SECONDS控制的正常行为不是格式化错误。修改~/.p10k.zsh属于编辑你自己的配置文件不涉及修改 powerlevel10k 仓库本身仓库中的config/*.zsh只是各风格的参考实现。如果符号显示不出来如问号变成乱码属于字体缺字形问题参考 README 的 Icons, glyphs or powerline symbols dont render重启终端、安装推荐字体后重新运行p10k configure。【免费下载链接】powerlevel10kA Zsh theme项目地址: https://gitcode.com/GitHub_Trending/po/powerlevel10k创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考