Oh My Zsh + Powerlevel10k 安装配置指南

在 macOS 上安装 Oh My Zsh 并配置 Powerlevel10k 主题，包括字体安装和终端美化。

前置条件

• macOS 系统
• 已安装 Homebrew
• 已安装 Git
• 使用 zsh 作为默认 shell（macOS 默认）

安装流程

按以下顺序执行安装，可使用 scripts/install.sh 一键完成，也可手动逐步操作。

一键安装

运行 skill 自带的安装脚本：

scripts/install.sh

脚本会自动完成以下所有步骤。如需手动安装，参照下方步骤。

手动安装步骤

步骤 1：备份 .zshrc

cp ~/.zshrc ~/.zshrc.backup.$(date +%Y%m%d%H%M%S)

步骤 2：安装 Oh My Zsh

先阅读官方说明以了解最新安装方式：https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/refs/heads/master/README.md

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended --keep-zshrc

关键：使用 --keep-zshrc 避免覆盖已有的 .zshrc 配置。

步骤 3：安装 MesloLGS Nerd Font 字体

Powerlevel10k 主题需要 Nerd Font 字体来正确显示特殊图标和符号。

brew install --cask font-meslo-lg-nerd-font

安装完成后需要在终端中设置字体为 MesloLGS Nerd Font（简称 MesloLGS NF）。

iTerm2 设置方法：

1. Preferences → Profiles → Text
2. 取消勾选 “Use built-in font”
3. 选择 “MesloLGS NF”

macOS 自带 Terminal 设置方法：

1. 偏好设置 → 配置文件 → 文本
2. 点击”字体”，选择 “MesloLGS NF”

步骤 4：安装 Powerlevel10k 主题

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/themes/powerlevel10k

步骤 5：安装插件所需的二进制工具

brew install eza      # 现代化的 ls 替代工具
brew install zoxide   # 智能 cd 替代工具

步骤 6：安装第三方 zsh 插件

# 命令自动建议
git clone --depth=1 https://github.com/zsh-users/zsh-autosuggestions \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

# 命令输入实时语法高亮
git clone --depth=1 https://github.com/zsh-users/zsh-syntax-highlighting.git \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

# 按片段搜索历史命令
git clone --depth=1 https://github.com/zsh-users/zsh-history-substring-search \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-history-substring-search

步骤 7：配置 .zshrc

将 ZSH_THEME 修改为 Powerlevel10k：

sed -i '' 's/^ZSH_THEME=.*/ZSH_THEME="powerlevel10k\/powerlevel10k"/' ~/.zshrc

将 .zshrc 中的 plugins=(...) 替换为：

plugins=(
  git
  zsh-autosuggestions
  zsh-syntax-highlighting
  eza
  history-substring-search
  jsontools
  history
  copyfile
  copybuffer
  copypath
  extract
  command-not-found
  zoxide
)

步骤 8：重启终端并配置 p10k

重启终端后会自动进入 Powerlevel10k 配置向导。如需重新配置：

p10k configure

插件功能说明

可选：安装 iTerm2 颜色主题

git clone --depth=1 https://github.com/mbadolato/iTerm2-Color-Schemes.git ~/iTerm2-Color-Schemes

推荐主题：Solarized、Gruvbox、One Dark / One Light、Ayu、Snazzy。

在 iTerm2 中导入：Preferences → Profiles → Colors → Color Presets → Import，选择 ~/iTerm2-Color-Schemes/schemes/ 目录下的 .itermcolors 文件。

可选：安装 Powerline 字体（仅在使用 agnoster 等旧主题时需要）

git clone https://github.com/powerline/fonts.git --depth=1 /tmp/powerline-fonts
cd /tmp/powerline-fonts && ./install.sh
rm -rf /tmp/powerline-fonts

常见问题排查

特殊字符显示为乱码：确认已安装 MesloLGS Nerd Font 字体，并且终端字体已设置为 “MesloLGS NF”。

验证字体是否安装成功：

brew install fontconfig  # 如果 fc-list 命令不存在
fc-list | grep -i meslo

p10k 配置向导未自动启动：手动运行 p10k configure。