English version: A Practical Ghostty-Based Terminal Stack.

基于 Ghostty 的现代 macOS 终端方案

终端不是越复杂越好。一个好用的日常终端环境，应该满足四件事：启动快、显示稳定、路径跳转顺手、常用命令可读性更好。最近我把本机终端方案整理成一套可重复安装的组合：

Ghostty + Maple Mono NF CN + zinit + Starship + zoxide + fast-syntax-highlighting + zsh-autosuggestions + fzf + Yazi + eza/ripgrep/fd/bat/btop/duf/httpie。

这套方案的目标不是把 shell 配成一个大型框架，而是用少量明确的工具替换旧的 Terminal.app + Oh My Zsh + 直接 source 插件 方案，让交互体验更现代，同时保留历史命令和旧配置的可回滚性。

一张图看整体思路

flowchart LR
  A[Ghostty<br/>GPU 加速终端] --> B[Maple Mono NF CN<br/>CJK 等宽与 Nerd Font 图标]
  B --> C[zsh 启动]
  C --> D[zinit<br/>延迟加载插件]
  D --> E[zsh-autosuggestions<br/>历史建议]
  D --> F[fast-syntax-highlighting<br/>语法高亮]
  C --> G[zoxide<br/>智能 cd]
  C --> H[Starship<br/>跨 shell prompt]
  C --> I[现代 CLI 别名<br/>eza rg fd bat btop duf]
  C --> J[fzf<br/>快捷键与补全]
  C --> K[Yazi<br/>终端文件管理器]

设计上，我把“终端模拟器”“字体渲染”“shell 插件”“prompt”“CLI 工具”拆开处理。每一层只做自己擅长的事，不把所有能力都塞进一个庞大的 zsh 框架里。

从旧方案迁移到新方案

旧方案通常长这样：

flowchart TB
  subgraph Old[旧方案]
    O1[Terminal.app] --> O2[Oh My Zsh]
    O2 --> O3[主题]
    O2 --> O4[直接 source autosuggestions]
    O2 --> O5[直接 source syntax-highlighting]
  end

  subgraph New[新方案]
    N1[Ghostty] --> N2[轻量 zsh]
    N2 --> N3[zinit 延迟加载插件]
    N2 --> N4[Starship prompt]
    N2 --> N5[zoxide + fzf]
    N2 --> N6[现代 CLI 工具]
  end

迁移时不删除 Oh My Zsh，也不删除旧插件。更稳妥的做法是：把旧的加载行注释掉，让它们不再影响启动性能；如果需要回滚，文件和插件仍然在。

工具与插件速览

常用别名设计

这些别名都应该做成“命令存在才启用”。这样在一台新机器上即使某个工具暂时安装失败，shell 仍然能正常启动。

这里有一个细节容易被误解：Yazi 退出后想让“父级 shell”自动 cd 到最后所在目录，不能只写 alias y="yazi"。原因是子进程无法直接修改父 shell 的当前目录。更稳妥的做法是用官方推荐的 --cwd-file 思路写一个很薄的 y() 函数：Yazi 退出时把目录写入临时文件，函数读出后再在当前 shell 里 cd。为了避免嵌套打开 Yazi，嵌套检测也应该放在函数内部，而不是在 .zshrc 顶层写 [[ -n "$YAZI_LEVEL" ]] && exit。

Yazi 的预览能力依赖一组小工具：ffmpegthumbnailer 用于视频缩略图，sevenzip 用于压缩包，poppler 用于 PDF，imagemagick 用于图片处理，jq 用于 JSON。把这些依赖放进安装脚本后，新机器打开 Yazi 时不会只得到一个空壳文件列表。

fzf、fd、bat 与 eza 的闭环联动

fzf 的体验不只来自快捷键本身，更来自默认数据源和预览命令。当前配置把 fd 作为文件/目录扫描入口，把 bat 用作文件预览，把 eza --tree 用作目录预览：

export FZF_DEFAULT_COMMAND='fd --type f --strip-cwd-prefix --hidden --follow --exclude .git'
export FZF_CTRL_T_COMMAND='fd --strip-cwd-prefix --hidden --follow --exclude .git'
export FZF_ALT_C_COMMAND='fd --type d --strip-cwd-prefix --hidden --follow --exclude .git'
export FZF_DEFAULT_OPTS="--ansi --preview 'if [ -d {} ]; then eza --tree --level=2 --icons=auto --group-directories-first {}; elif command -v bat >/dev/null 2>&1; then bat --style=numbers --color=always --line-range :500 {}; else sed -n \"1,500p\" {}; fi'"

这些变量要放在 source <(fzf --zsh) 之前。实际加载 fzf 时仍然要用 [[ -t 0 && -o zle ]] 做交互 shell 保护，避免自动化脚本或非交互命令被 fzf/ZLE 初始化噪声影响。

历史命令必须保留

迁移 shell 时最容易被忽略的是历史命令。我的做法是显式保留原有 ~/.zsh_history：

export HISTFILE="${HISTFILE:-$HOME/.zsh_history}"
export HISTSIZE=100000
export SAVEHIST=100000
setopt APPEND_HISTORY
setopt EXTENDED_HISTORY
setopt INC_APPEND_HISTORY
setopt SHARE_HISTORY
setopt HIST_IGNORE_DUPS
setopt HIST_REDUCE_BLANKS
setopt HIST_VERIFY

这样打开新的 Ghostty 窗口后，原来的历史命令仍然可以被 zsh、fzf 和 zsh-autosuggestions 继续使用。

为什么不用继续堆 Oh My Zsh

Oh My Zsh 的优点是开箱即用，缺点是它经常把主题、插件、补全和框架行为绑在一起。长期使用后，启动路径会变得不透明：到底是哪段脚本慢、哪个插件影响粘贴、哪段配置覆盖了补全行为，都不容易定位。

这套新方案的思路是：

推荐 Ghostty 主题

Ghostty 的主题名必须来自 ghostty +list-themes，否则应用会在启动时报配置错误。我的偏好顺序是：

当前默认使用：

theme = "TokyoNight Night"

配置完成后一定要验证：

ghostty +validate-config --config-file="$HOME/.config/ghostty/config"

可重复执行的安装原则

这套配置适合沉淀成一个幂等脚本。脚本应该做到：

1. 检查 macOS 与 Homebrew。
2. 安装 Ghostty、Maple Mono NF CN、zinit、Starship、zoxide、Yazi 和现代 CLI 工具。
3. 注释旧 Oh My Zsh 与旧插件加载行，而不是删除它们。
4. 用 marker block 管理 ~/.zshrc，重复执行时替换块而不是追加重复配置。
5. 写入 Ghostty、Starship 与 Yazi 配置。
6. 在 source fzf 前写入 fd、bat、eza 预览联动变量。
7. prime 一次 zinit 插件，让首次打开终端时不再等待克隆。
8. 运行 zsh -n ~/.zshrc 和 ghostty +validate-config。

flowchart TD
  A[运行安装脚本] --> B{Homebrew 可用?}
  B -- 否 --> C[提示先安装 Homebrew]
  B -- 是 --> D[安装 formulae 与 casks]
  D --> E[备份并更新 zshrc]
  E --> F[写入 Ghostty 配置]
  F --> G[写入 Starship 与 Yazi 配置]
  G --> H[预热 zinit 插件]
  H --> I[验证 zsh、Yazi 与 Ghostty 配置]
  I --> J[打开新的 Ghostty 窗口]

Ghostty 与配套工具快速上手指南

这一节集中列出日常最高频的配置命令、快捷键和工具用法，方便以后直接查阅。

Ghostty

当前字体配置使用 Maple Mono NF CN，中英文与图标会保持一致的等宽基线：

font-family = "Maple Mono NF CN"

常用命令：

# 校验配置
ghostty +validate-config --config-file="$HOME/.config/ghostty/config"

# 让已打开的 Ghostty 窗口热加载新配置
ghostty +reload-config

# 查看 Ghostty 能识别的字体族
ghostty +list-fonts | rg -i "Maple Mono NF CN"

# 查看可用主题，主题名必须来自这个列表
ghostty +list-themes

zsh 插件

• zsh-autosuggestions：命令输入时出现灰色历史建议，按 Right 或 End 接受；继续输入即可忽略。
• fast-syntax-highlighting：无需额外操作，命令、参数、路径会在输入时自动 高亮。

Starship

Prompt 由 Starship 渲染，Git 状态、目录、语言版本和命令耗时都集中在这里：

starship --version
cat ~/.config/starship.toml

zoxide

当前 shell 把 zoxide 初始化为 --cmd cd，所以直接使用 cd 就会获得智能跳转：

cd projects
cd mobile-workspace
cd -

# 显式查询 zoxide 数据库
zoxide query <keyword>

fzf

当前配置使用 fd 作为数据源，文件预览使用 bat，目录预览使用 eza --tree。

Yazi

用 y 打开 Yazi（yy 是兼容别名）。退出后，y() 函数会把当前 shell 切换到 Yazi 最后所在的目录。

在 Yazi 内按 ~ 或 F1 可以查看完整帮助和全部键位。

Atuin

atuin search <keyword>
atuin stats
atuin history
atuin daemon status

Atuin 启用后，Ctrl-R 打开的是 Atuin 的历史搜索界面。

现代 CLI 别名

ll          # eza 长列表，显示 Git 状态
la          # eza 长列表，包含隐藏文件
lt          # eza 两级树状视图
rg PATTERN  # ripgrep 全文搜索
fd NAME     # fd 文件搜索
bat FILE    # bat 语法高亮查看文件
btop        # 交互式资源监控
duf         # 易读磁盘使用视图
http GET https://example.com

这套方案的收益

最终得到的是一个更清晰的终端栈：

• 终端显示由 Ghostty 与 Maple Mono NF CN 负责，中文、英文和图标保持统一等宽。
• zsh 只保留必要的 shell 行为。
• 插件由 zinit 延迟加载。
• prompt 交给 Starship。
• 路径跳转交给 zoxide。
• 终端文件浏览和预览交给 Yazi。
• 搜索、列表、查看、监控、HTTP 调试交给更现代的 CLI 工具。
• 旧配置保留但不再参与启动。

这不是“把终端配得更花”，而是把常用交互路径拆清楚：哪里负责渲染，哪里负责补全，哪里负责搜索，哪里负责提示，哪里负责可读性。拆清楚之后，配置更容易迁移，也更容易维护。