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 设置方法：
-
Preferences → Profiles → Text
-
取消勾选 "Use built-in font"
-
选择 "MesloLGS NF"
macOS 自带 Terminal 设置方法：
-
偏好设置 → 配置文件 → 文本
-
点击"字体"，选择 "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
插件功能说明
插件 类型 功能
git 内置 Git 命令别名和补全
zsh-autosuggestions 第三方 根据历史记录自动建议命令
zsh-syntax-highlighting 第三方 命令输入实时语法高亮
history-substring-search 第三方 按↑↓键基于片段搜索历史命令
eza 内置 为 eza（现代 ls）提供别名
zoxide 内置 为 zoxide（智能 cd）提供集成
jsontools 内置 JSON 格式化工具（pp_json 等）
history 内置 历史命令管理别名
copyfile 内置 复制文件内容到剪贴板
copybuffer 内置 Ctrl+O 复制当前命令行到剪贴板
copypath 内置 复制当前路径到剪贴板
extract 内置 智能解压各种压缩格式
command-not-found 内置 命令未找到时提示安装方式
可选：安装 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 。