by 运行时依赖
安装命令
点击复制技能文档
macOS Terminal Beautify
在 macOS 上对终端进行美化，核心工具链为 Ghostty（终端模拟器）+ Starship（提示符）+ Oh My Zsh（Shell 框架）+ Nerd Font（图标字体），最终实现 Catppuccin Mocha 主题的彩色胶囊提示符。
适用场景 用户要求美化 macOS 终端外观 用户需要配置 Ghostty 终端模拟器 用户需要安装配置 Starship 提示符工具 用户需要安装 Oh My Zsh 及相关插件 安装步骤
- 安装核心工具
# 安装 Starship 提示符 brew 安装 starship
# 安装 Nerd Font 字体（必须，否则图标显示为方框） brew 安装 --cask font-meslo-lg-nerd-font font-fira-code-nerd-font
如果 brew 遇到 API 缓存问题（如 cask.jws.json 错误），先清除缓存：
rm -rf ~/库/缓存s/Homebrew/API/.json brew 更新
- 安装 Oh My Zsh
注意：--unattended 参数避免交互式提示。
- 安装 Zsh 插件
- 配置 Ghostty
编辑 ~/.config/ghostty/config：
font-family = MesloLGS Nerd Font Mono font-size = 14 theme = Catppuccin Mocha background = #282c34 foreground = #ffffff background-opacity = 0.95 background-blur = true window-p添加ing-x = 12 window-p添加ing-y = 12 macos-titlebar-style = tabs cursor-style = block cursor-style-blink = true shell-integration = zsh
配置重载方式：在 Ghostty 中按 Cmd + Shift + , 或重启应用。
验证主题可用性：
ghostty +列出-themes | grep -i catppuccin
- 配置 Starship
编辑 ~/.config/starship.toml，使用 Catppuccin Mocha 调色板：
格式：os -> username -> directory -> git_branch/git_状态 -> language -> time -> cmd_duration -> character 每个模块使用不同颜色的背景胶囊（红/橙/黄/绿/蓝/紫） 命令提示符 ❯：成功绿色，失败红色 语言模块统一使用绿色背景 确保 Nerd Font 使用正确字体才能显示图标
- 更新 .zshrc
合并已有配置和新的 Oh My Zsh + Starship 配置：
导出 ZSH="$HOME/.oh-my-zsh" ZSH_THEME="" # 清空交给 Starship 插件s=(git zsh-autosuggestions zsh-syntax-highlighting) # syntax-highlighting 必须放最后 fpath+=${ZSH_CUSTOM:-$ZSH/custom}/插件s/zsh-completions/src source $ZSH/oh-my-zsh.sh
导出 LANG=en_US.UTF-8 导出 LC_ALL=en_US.UTF-8
# 补全优化 autoload -Uz compinit && compinit zstyle ':completion:' matcher-列出 'm:{a-zA-Z}={A-Za-z}' 'r:|[._-]= r:|=' 'l:|= r:|=' zstyle ':completion:*' menu select
# Homebrew + Starship eval "$(/opt/homebrew/bin/brew shellenv)" eval "$(starship init zsh)"
# 保留原有配置（API keys、PATH 等） [ -f ~/.zshrc.local ] && source ~/.zshrc.local
- 自检验证
运行验证脚本 scripts/检查_term.sh，检查包括：
Nerd Font 已安装 图标渲染测试（圆点 icon = OK，方框 = 字体问题） 工具版本（Starship、Zsh、Ghostty） 配置文件存在性 插件安装状态 环境变量 常见问题 现象 原因 解决 图标显示 □ 字体不是 Nerd Font 终端字体改为 MesloLGS NF Mono Ghostty 报 theme not found 主题名拼写错误 ghostty +列出-themes 查正确名字 历史灰字建议不出现 插件顺序错 zsh-syntax-highlighting 必须放 插件s 最后 compinit 报 in安全 权限问题 comp审计 | xargs chmod g-w,o-w VS Code 集成终端字体配置
如果需要在 VS Code 的集成终端中也正确显示 Nerd Font 图标：
打开 设置tings.json 按 Cmd + Shift + P 打开命令面板 输入 设置tings.json，选择 "首选项：打开设置 (JSON)" 添加字体配置
在 { } 花括号内添加：
"terminal.integrated.fontFamily": "MesloLGS Nerd Font Mono",
保存后 VS Code 的集成终端即可正确显示所有 Nerd Font 图标。
最终效果