• 开发工具

本指南以 YADR dotfiles 仓库官方文档 doc/zsh/themes.md 为核心，讲解如何为 YADR 的 Zsh 环境添加自定义主题、通过~/.zsh.before/与~/.zsh.after/两个钩子目录做个性化定制，以及如何彻底覆盖 YADR 默认的skwp提示符主题。读完本文，你将掌握prompt_[name]_setup命名约定、promptinit主题加载器的 fpath 顺序、仓库内置四大主题的源码结构，以及一套可立即照搬的自定义主题样板。

YADR 的 Zsh 主题体系概览

YADR 的 Zsh 部分建立在 Prezto 之上：仓库以子模块形式引入 Prezto（见 .gitmodules），并在 zsh/prezto-override/zshrc 中先source $HOME/.zprezto/runcoms/zshrc，随后按字典序逐个加载$HOME/.yadr/zsh/*.zsh。也就是说，主题相关的配置并非只由 Prezto 决定，而是由 YADR 自己的加载脚本最终拍板。

整个主题体系由三个关键部分组成：

因此，虽然zpreztorc中 Prezto 默认主题是sorin，但 YADR 实际生效的默认提示符是仓库内置的skwp主题。理解这一"两段式"覆盖关系，是后续所有定制操作的前提。

理解 promptinit 加载器与 fpath 优先级

YADR 的主题加载完全依赖 zsh 自带的promptinit机制。zsh/custom_prompt_path.zsh 的源码只有三行，却定义了整个加载顺序：

# Load themes from yadr and from user's custom prompts (themes) in ~/.zsh.prompts autoload promptinit fpath=($HOME/.yadr/zsh/prezto-themes $HOME/.zsh.prompts $fpath) promptinit

要点逐条拆解：

• autoload promptinit：将 zsh 的提示符初始化函数加入自动加载队列；
• fpath的构造顺序：依次为仓库内置主题目录$HOME/.yadr/zsh/prezto-themes、用户自定义主题目录$HOME/.zsh.prompts、以及原有$fpath。fpath是 zsh 的函数搜索路径，promptinit正是沿着fpath查找prompt_<名称>_setup形式的文件；
• promptinit：完成主题注册，此后即可使用prompt <名称>切换、prompt -l列出全部可用主题。

promptinit的约定是：每个主题必须是一个名为prompt_[name]_setup的可自动加载函数。这也是文档中强调"命名约定"（naming convention）的根本原因——文件名决定了主题名，函数名决定了加载逻辑，两者必须保持一致。

添加自己的 Zsh 主题：~/.zsh.prompts 实战

文档给出的核心操作非常简洁：把自定义主题放进~/.zsh.prompts目录，并遵循prompt_[name]_setup命名约定，它就会被主题加载器自动拾取。

touch ~/.zsh.prompts/prompt_mytheme_setup

仅touch一个空文件虽然能让主题出现在prompt -l列表中，但要真正改变提示符，还需按 zsh 主题规范填充内容。参照仓库内置主题的成熟结构，一个最小可用的自定义主题应包含：定义prompt_mytheme_setup函数、在其中设置PROMPT（以及可选的RPROMPT）、最后以prompt_mytheme_setup "$@"结尾立即执行。下面是一个可直接复制使用的完整示例：

# ~/.zsh.prompts/prompt_mytheme_setup function prompt_mytheme_setup { # 简单清晰的单行提示符：user@host 目录，带 git 信息 PROMPT='%F{cyan}%n%f@%F{green}%m%f %F{magenta}%~%f %(?..%F{red}%?%f )$ ' RPROMPT='%F{blue}$(git branch --show-current 2>/dev/null)%f' } prompt_mytheme_setup "$@"

创建后重启 shell（或执行source $HOME/.zshrc），即可用prompt mytheme启用该主题。这种"文件名即主题名、函数即实现"的结构，与仓库内置主题完全同构——例如 zsh/prezto-themes/prompt_kylewest_setup 定义了prompt_kylewest_setup函数并以prompt_kylewest_setup "$@"收尾，zsh/prezto-themes/prompt_steeef_simplified_setup 亦是如此。

~/.zsh.prompts目录本身由安装流程自动创建。查看 Rakefile 的install_prezto任务可以看到，安装时会执行：

mkdir -p $HOME/.zsh.before mkdir -p $HOME/.zsh.after mkdir -p $HOME/.zsh.prompts

如果你的环境里这三个目录尚不存在（例如手动同步仓库而未运行安装），可以按同样命令自行创建。

用 prompt 命令管理、切换与预览主题

启用promptinit后，zsh 提供了一套prompt命令族，文档中明确推荐用它来发现可用主题：

prompt -l # 列出所有可用主题 prompt -p # 预览当前主题 prompt <名称> # 切换到指定主题

prompt -l的列表来源正是fpath中所有符合prompt_*_setup命名的文件，因此仓库内置的skwp、steeef_simplified、kylewest、agnoster以及你放进~/.zsh.prompts的自定义主题都会出现在其中。prompt命令的切换效果是即时的、只对当前会话生效；若要持久生效，需要借助下一节介绍的文件级配置。

仓库内置主题源码巡礼

~/.yadr/zsh/prezto-themes目录（即仓库的 zsh/prezto-themes）内置了四个主题，它们既是开箱可用的主题，也是学习自定义主题的最佳样板。

skwp（YADR 默认主题）

zsh/prezto-themes/prompt_skwp_setup 是 steeef 主题的改进版，特征为：git 信息在左侧、RVM/Rbenv 的 Ruby 版本信息在右侧、单行提示符。其核心结构值得注意：

• 通过add-zsh-hook precmd prompt_skwp_precmd注册钩子，在每条命令执行前调用git-info与ruby-info收集状态；
• 根据$TERM是否包含256color自动选择 256 色扩展调色板（青色%F{81}、橙色%F{166}、紫色%F{135}、粉红%F{161}、黄绿%F{118}）或基础色；
• 用zstyle配置 Prezto 的 git 模块输出格式（分支名、新增/删除/修改/未跟踪标记），最终拼装PROMPT与RPROMPT。

由于 zsh/theme.zsh 中执行了prompt skwp，这就是你安装 YADR 后看到的默认提示符。

steeef_simplified

zsh/prezto-themes/prompt_steeef_simplified_setup 基于 Steve Losh 的 Extravagant Prompt，改用 zsh 内置的vcs_info而非 Prezto 的 git 模块。其precmd钩子会额外检测未跟踪文件（git ls-files --other --exclude-standard），并在分支信息后追加●标记；同时通过zstyle ':vcs_info:*' enable bzr git hg svn支持 bzr、git、hg、svn 多种版本控制系统。

kylewest

zsh/prezto-themes/prompt_kylewest_setup 基于 sorin 主题，最大特色是集成 Prezto 的 editor 模块：在正常模式下显示绿色$>，vi 命令模式下显示紫色<#，补全进行中显示红色...，让 vim 用户一目了然地知道当前处于何种输入模式。

agnoster

zsh/prezto-themes/prompt_agnoster_setup 是 Powerline 风格主题，通过prompt_segment/prompt_end两个工具函数绘制带分隔符⮀的分段提示符，按需显示状态（错误✘、root⚡、后台任务⚙）、用户与主机、目录、git 分支及脏状态。其文件头部明确说明：该主题依赖 Powerline 修补字体（仓库的 fonts 目录正提供了Menlo-Powerline.otf、Inconsolata-dz-Powerline.otf等修补字体），并推荐配合 Solarized 配色使用。

用 ~/.zsh.before 与 ~/.zsh.after 钩子做增量定制

文档指出，YADR 提供两个定制钩子目录：~/.zsh.before/与~/.zsh.after/，分别用于在 YADR 自身配置加载之前与之后注入你的代码。这一机制的实现位于仓库的两个加载脚本中。

zsh/0000_zsh（文件名以0开头，保证在字典序加载中排在首位）负责加载 before 钩子：

# Load any user customizations prior to load if [ -d $HOME/.zsh.before/ ]; then if [ "$(ls -A $HOME/.zsh.before/)" ]; then for config_file ($HOME/.zsh.before/*.zsh) source $config_file fi fi

zsh/zzzz_after.zsh（文件名以z开头，保证排在末位）负责加载 after 钩子：

# Load any custom after code if [ -d $HOME/.zsh.after/ ]; then if [ "$(ls -A $HOME/.zsh.after/)" ]; then for config_file ($HOME/.zsh.after/*.zsh) source $config_file fi fi

两个脚本都遵循同一规则：目录存在且非空时，按字典序source其中所有*.zsh文件。由此得到完整的加载时序：

1. ~/.zsh.before/*.zsh—— 先于一切 YADR 配置执行，适合提前设定环境变量、预定义函数；
2. ~/.yadr/zsh/*.zsh中的其余配置 —— 包括主题加载与默认主题启用；
3. ~/.zsh.after/*.zsh—— 最后执行，适合覆盖 YADR 已设置的任何内容，包括主题。

这一设计让你无需修改仓库任何文件即可注入或覆盖配置，是 YADR "先有默认、后有钩子"定制哲学的落地。

覆盖默认主题：~/.zsh.after/prompt.zsh

文档给出的主题覆盖方法正是 after 钩子的典型应用：

echo "prompt yourprompt" > ~/.zsh.after/prompt.zsh

其工作原理与前文的加载时序完全吻合：~/.zsh.after/中的文件在 YADR 的theme.zsh（prompt skwp）之后被source，因此prompt yourprompt会再次调用promptinit切换函数，把最终主题替换为yourprompt。下次启动 shell 时该文件即被自动读取。

完整的落地步骤：

# 1. 查看当前可用的全部主题 prompt -l # 2. 把想要持久生效的主题写入 after 钩子 echo "prompt kylewest" > ~/.zsh.after/prompt.zsh # 3. 重启 shell 或重新加载配置后生效 source $HOME/.zshrc

两个实用提示：

• 若只想临时试用某个主题而不持久修改，直接用prompt kylewest即可，无需创建文件；
• 若想恢复 YADR 默认的skwp主题，删除或清空~/.zsh.after/prompt.zsh即可，仓库的 zsh/theme.zsh 会继续以prompt skwp作为兜底。

组合玩法：自定义主题 + after 钩子一键切换

将前三节内容串联起来，即可实现"自定义主题、随时切换"的完整工作流：

# 1. 创建自定义主题（命名必须为 prompt_<名称>_setup） cat > ~/.zsh.prompts/prompt_mytheme_setup <<'EOF' function prompt_mytheme_setup { PROMPT='%F{cyan}%n%f@%F{green}%m%f %F{magenta}%~%f $ ' } prompt_mytheme_setup "$@" EOF # 2. 验证主题已被 promptinit 识别 prompt -l # 3. 通过 after 钩子将其设为默认，实现持久生效 echo "prompt mytheme" > ~/.zsh.after/prompt.zsh # 4. 重新加载配置并确认 source $HOME/.zshrc

如果你安装了 agnoster 这类依赖特殊字形的主题，务必先安装仓库 fonts 目录下的 Powerline 修补字体（Linux 下放入~/.fonts并运行fc-cache），否则分段分隔符会显示为乱码方块——这一点同样可以从 zsh/prezto-themes/prompt_agnoster_setup 文件头部的使用说明中得到印证。

小结

YADR 的 Zsh 主题体系围绕三条主线展开：promptinit加载器沿fpath自动发现~/.zsh.prompts中的prompt_[name]_setup主题文件；~/.zsh.before/与~/.zsh.after/两个钩子目录分别承载前置定制与最终覆盖；而覆盖默认主题只需一条echo "prompt xxx" > ~/.zsh.after/prompt.zsh。掌握这三条主线后，无论是复用仓库内置的skwp、kylewest、steeef_simplified、agnoster，还是完全自创风格，都能在不触碰仓库源码的前提下完成——这正是 YADR 保持"干净 vimrc、可无限扩展"设计理念在 Zsh 侧的延续。

• 开发工具