Powerlevel10k主题需依次完成安装、启用、配置Nerd字体、运行p10k configure向导及验证；未生效主因是主题未克隆至custom/themes、ZSH_THEME未正确设置、缺少Meslo Nerd字体或未执行source ~/.zshrc。
如果您已配置好Zsh与Oh My Zsh环境，但终端仍显示默认样式，说明Powerlevel10k主题尚未安装或未启用。以下是完成Powerlevel10k安装与基础启用的完整操作流程：
一、安装Powerlevel10k主题文件
该步骤将主题源码克隆至Oh My Zsh的自定义主题目录，使Zsh在启动时能识别并加载该主题。主题文件需放置于${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/路径下，否则启用会失败。
1、打开终端，执行以下命令克隆Powerlevel10k仓库：
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k
2、确认克隆成功：运行ls ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k，应看到config/p10k-*.zsh等文件存在。
3、若提示command not found: git，需先安装Git：xcode-select --install。
二、启用Powerlevel10k主题
启用主题需修改Zsh主配置文件~/.zshrc，将ZSH_THEME变量值设为powerlevel10k/powerlevel10k，否则即使文件存在也不会加载。
1、使用文本编辑器打开配置文件：vi ~/.zshrc（或用code ~/.zshrc调用VS Code）。
2、查找以ZSH_THEME=开头的行，将其修改为：
ZSH_THEME="powerlevel10k/powerlevel10k"
3、保存并退出编辑器（vi中按Esc后输入:wq回车）。
4、重新加载配置：source ~/.zshrc。
三、安装配套Nerd字体
Powerlevel10k依赖Nerd Font（如Meslo LG M Regular Nerd Font）渲染图标与分隔符。若未安装，终端将显示方块或乱码，主题视觉效果严重受损。
1、访问Powerlevel10k官方字体页面，下载MesloLGS NF系列字体（推荐MesloLGS NF Regular.ttf和MesloLGS NF Bold.ttf）。
2、双击下载的.ttf文件，点击“安装字体”按钮（macOS字体册自动处理）。
3、在iTerm2中设置字体：打开iTerm2 → Preferences → Profiles → Text，将“Font”和“Non-ASCII Font”均设为MesloLGS NF。
4、若使用系统终端（Terminal.app），进入Preferences → Profiles → Text → Change...，选择已安装的MesloLGS NF字体。
四、运行交互式配置向导
p10k configure是Powerlevel10k的核心初始化工具，它会检测环境并引导用户选择布局、图标、颜色等选项，生成个性化~/.p10k.zsh配置文件。
1、在终端中输入：p10k configure。
2、若提示command not found: p10k，说明未正确启用主题或未重启shell，请先执行source ~/.zshrc再重试。
3、向导首次运行时，若检测到未安装Nerd字体，会提供一键下载选项；此时需确保iTerm2已关闭，否则下载可能失败。
4、根据屏幕提示，使用方向键选择偏好项（如Prompt Style选Lean，Icons选Yes），全部完成后按回车确认生成配置。
五、验证与故障排查
该步骤用于确认主题是否生效，并定位常见失效原因。若终端未变化，问题通常出在字体、配置加载或Shell环境层面。
1、检查当前Shell是否为Zsh：echo $SHELL，输出应为/bin/zsh；若为/bin/bash，执行chsh -s /bin/zsh并重启终端。
2、确认.zshrc中无语法错误：运行zsh -n ~/.zshrc，无输出表示语法合法。
3、强制重载并调试：ZSH_THEME="" source ~/.zshrc && ZSH_THEME="powerlevel10k/powerlevel10k" source ~/.zshrc，观察是否出现p10k初始化提示。
4、若仍显示空白或报错，检查~/.p10k.zsh是否存在且可读：ls -l ~/.p10k.zsh，权限应为-rw-r--r--。
