English version: A Practical Ghostty-Based Terminal Stack.

基于 Ghostty 的现代 macOS 终端方案

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

Ghostty + JetBrainsMono Nerd Font + 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[JetBrainsMono Nerd Font<br/>图标与等宽字体]
  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 的预览能力依赖一组小工具：ffmpegthumbnailer 用于视频缩略图，sevenzip 用于压缩包，poppler 用于 PDF，imagemagick 用于图片处理，jq 用于 JSON。把这些依赖放进安装脚本后，新机器打开 Yazi 时不会只得到一个空壳文件列表。

历史命令必须保留

迁移 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、Nerd Font、zinit、Starship、zoxide、Yazi 和现代 CLI 工具。
3. 注释旧 Oh My Zsh 与旧插件加载行，而不是删除它们。
4. 用 marker block 管理 ~/.zshrc，重复执行时替换块而不是追加重复配置。
5. 写入 Ghostty、Starship 与 Yazi 配置。
6. prime 一次 zinit 插件，让首次打开终端时不再等待克隆。
7. 运行 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 与 Nerd Font 负责。
• zsh 只保留必要的 shell 行为。
• 插件由 zinit 延迟加载。
• prompt 交给 Starship。
• 路径跳转交给 zoxide。
• 终端文件浏览和预览交给 Yazi。
• 搜索、列表、查看、监控、HTTP 调试交给更现代的 CLI 工具。
• 旧配置保留但不再参与启动。

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