iTerm2主题配置异常需依次完成配色方案导入、Nerd Fonts安装、oh-my-zsh主题设置、p10k向导初始化及字体兼容性验证。

如果您已安装iTerm2但终端界面显示异常符号、状态栏图标缺失或配色单调，则很可能是主题未生效或缺少Powerline/Nerd Fonts支持字体。以下是完成iTerm2主题与字体配置的多种可行路径：

一、导入预设配色方案

配色方案直接影响视觉舒适度与代码可读性，Solarized Dark Higher Contrast等专业方案已针对深色环境优化对比度与护眼特性。

1、访问https://github.com/mbadolato/iTerm2-Color-Schemes/releases 下载最新版 ZIP 包。

2、解压后进入 schemes/ 目录，定位到 Solarized Dark Higher Contrast.itermcolors 文件。

3、双击该文件，系统自动将其注册至iTerm2配置库。

4、启动iTerm2，按 Cmd + , 打开 Preferences，依次选择 Profiles → Colors → Color Presets → Solarized Dark Higher Contrast。

二、安装并启用Nerd Fonts

Nerd Fonts 提供完整图标集（如 Git 分支箭头、语言标识符），是 powerlevel10k、agnoster 等主题正常渲染的必要前提。

1、从 https://github.com/romkatv/powerlevel10k#manual-font-installation 页面下载 MesloLGS NF Regular.ttf 及配套粗体、斜体变体。

2、逐个双击 .ttf 文件，在弹出的字体册窗口中点击“安装字体”。

3、回到 iTerm2 Preferences → Profiles → Text → Change Font，从字体列表中选择 MesloLGS NF（注意末尾必须含 “NF”）。

4、勾选 Use a different font for non-ASCII text，并同样设置为 MesloLGS NF。

三、手动配置 oh-my-zsh 主题

oh-my-zsh 的主题依赖正确字体与 shell 环境，直接编辑配置文件可绕过自动向导失败风险。

1、确认已安装 oh-my-zsh：执行 ls ~/.oh-my-zsh，若返回目录内容则已存在。

2、使用编辑器打开配置文件：nano ~/.zshrc。

3、查找以 ZSH_THEME= 开头的行，将其修改为以下任一选项：

　　ZSH_THEME="powerlevel10k/powerlevel10k"

　　ZSH_THEME="agnoster"

4、保存退出后执行：source ~/.zshrc 使更改立即生效。

四、通过 p10k 配置向导初始化主题

powerlevel10k 自带交互式配置流程，能自动检测缺失组件并引导修复，适合首次部署或疑难排错。

1、确保已安装 powerlevel10k：ls ~/.oh-my-zsh/custom/themes/powerlevel10k 应返回路径。

2、在终端中运行：p10k configure。

3、若提示“font not found”，先退出 iTerm2，重新启动后再次运行该命令。

4、根据屏幕提示选择样式、图标风格、颜色模式等，全程使用方向键与回车确认。

5、完成配置后，新窗口将直接呈现完整渲染的主题界面。

五、验证字体与主题兼容性

iTerm2 渲染异常常源于字体未正确加载或 ASCII/non-ASCII 字体不一致，此步骤用于快速定位根源。

1、在 iTerm2 中执行：echo "\uE0B0\uE0B1"，应显示连续箭头符号（如 ▶▶）而非方块或空格。

2、执行：git status，观察左侧 Git 状态栏是否显示分支名与修改标识，而非乱码。

3、若任一测试失败，返回第二步检查字体名称拼写及非 ASCII 字体是否同步设置为 MesloLGS NF。