Powerlevel10k 图标不显示？字体与 p10k configure 完整快速修复指南
【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具，去水印，支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader
Powerlevel10k 的图标、字形或 Powerline 符号在 zsh 提示符里不显示？多半是字体问题：装上推荐字体 MesloLGS NF，再跑一次p10k configure重新生成配置，基本一次搞定。
30 秒自测：先分清你属于哪种情况 🔍
装字体之前，先花 30 秒判断你在哪个分支——三种情况的修复路径完全不同，别一上来就乱装。在终端输入这一条命令：
echo '\u276F'情况 A：你看到的是普通问号?
如果提示符里的是普通?，那根本不是字体问题。它是 Powerlevel10k 表示"当前 git 仓库有未跟踪（untracked）文件"的默认符号，输入git status就能看到这些文件。想换掉它或不显示，打开~/.p10k.zsh，搜索untracked files，改对应参数即可。
情况 B：报错zsh: character not in range
说明你的 locale 不支持 UTF-8，字体是后话，先把字符编码修好。用这两条确认前提：
locale -a print -r -- ${options[MULTIBYTE]}- 前者列出系统全部 locale，没有 UTF-8 就先装一个（通过 SSH 跑 Zsh 的情况，见 README.md 对应条目的讨论；本地运行按你的系统搜 "set UTF-8 locale"）；
MULTIBYTE是 Zsh 的内置选项，默认启用，不应该被禁用。它被关掉的后果是：配置向导压根不会提供使用 Unicode 字符的提示符样式。
情况 C：正常打印出❯，但图标还是不显示
字符本身能输出，提示符图标却缺失或变成方块乱码——说明字体没装对，进入下面的字体链路。
安装字体：按终端分流
先说结论：Powerlevel10k 并不强制你换字体，但只有用 Nerd Fonts 时全部样式选项才可用。推荐字体Meslo Nerd Font patched for Powerlevel10k包含了 Powerlevel10k 可能需要的所有字形，并且在数十种终端、主流操作系统上实测过（详见 font.md 的 Fonts 章节）。
自动安装（iTerm2 / Termux）
用 iTerm2 或 Termux 的话，直接跑p10k configure，它问你是否安装Meslo Nerd Font时回答Yes，剩下它自己来。
手动安装（其他终端）
第一步：拿到字体文件。下载这四个 ttf，链接都在 font.md：
MesloLGS NF Regular.ttfMesloLGS NF Bold.ttfMesloLGS NF Italic.ttfMesloLGS NF Bold Italic.ttf
第二步：安装。逐个双击并点 "Install"，MesloLGS NF就对全系统应用可用了。装不上就把它当普通字体处理，按你的系统搜 "how to install fonts"（对应 README.md 里 "Cannot install the recommended font" 一节的说法）。
第三步：把终端字体设为MesloLGS NF。关键路径如下：
| 终端 | 设置路径 |
|---|---|
| iTerm2 | iTerm2 → Preferences → Profiles → Text，把Font设为MesloLGS NF |
| Apple Terminal | Terminal → Preferences → Profiles → Text，点Font下的Change，选MesloLGS NF字体族 |
| Windows Terminal | Settings（Ctrl+,）→ 选某个 profile 或Defaults→Appearance，Font face设为MesloLGS NF |
| GNOME Terminal | Terminal → Preferences → 选 profile，在Text Appearance勾选Custom font并选MesloLGS NF Regular |
| Alacritty | 创建或打开~/.config/alacritty/alacritty.toml，加[font.normal]段落，family = "MesloLGS NF" |
VS Code、Konsole、kitty、WezTerm、puTTY 等其他终端的完整步骤，见 font.md。
重新生成配置并重启终端
为什么字体装完不能直接用？因为~/.p10k.zsh是按旧字体生成的，文档明确提醒：旧配置在新字体下可能工作不正确。所以必须再跑一次p10k configure重新生成配置，这一步不能省。
然后重启终端让设置生效。最可靠的做法是退出当前会话、再开一个新的 Zsh 会话；嫌麻烦也可以用exec zsh代替完整重启。
验证清单 ✅
三项都过，才算修好：
echo '\u276F'正常打印❯——字符层面没问题；- UTF-8 locale 可用、
MULTIBYTE启用——向导提供 Unicode 样式的前提； - 运行
p10k configure：向导前几个问题会评估你终端字体的能力，检查所有字形是否都正确渲染。
如果 Unicode 样式依然没出现在向导里，说明前提（Zsh 版本、UTF-8 locale、MULTIBYTE、字体）还没满足，而不是提示符本身有问题。
疑难现象速查表
| 现象 | 原因 | 对策 |
|---|---|---|
| 光标位置不对 | 字体指标或提示符缩进问题 | 装推荐字体 + 跑p10k configure；仍不生效就在~/.zshrc底部加unset ZLE_RPROMPT_INDENT |
| Arch Linux 图标右下角多一个点 | 部分字体在粗体下渲染出错误圆点 | 换粗体下渲染正确的字体（如推荐字体）；或打开~/.p10k.zsh，搜POWERLEVEL9K_OS_ICON_CONTENT_EXPANSION，从取值中移除%B（即${P9K_CONTENT}不加粗显示） |
| Konsole 中图标被截断 | 非等宽字体存在宽于单列的字形 | 换等宽字体（推荐字体即等宽）、换终端、给被截断的图标手动补一个空格，或改用纯文本图标 / 禁用该段（如把POWERLEVEL9K_OS_ICON_CONTENT_EXPANSION末尾补一个空格） |
| Powerline 符号有细缝、连接错位 | sub-pixel 渲染瑕疵，不属于"不显示" | 换推荐字体；终端字号调 ±1 点（文档举例 iTerm2 在 11、13 号正常、12 号出错）；启用终端内建 Powerline 字形（iTerm2 支持）；调整字体 hinting / 抗锯齿。更彻底：跑p10k configure选Lean样式——无背景色，不受 powerline 渲染瑕疵影响 |
一条链路串完全文
装推荐字体 →p10k configure重新生成~/.p10k.zsh→ 重启终端 → 用echo '\u276F'和向导的字形检查确认结果。
zsh 主题字体修复这件事，按这条链路走，绝大多数"图标不显示怎么办"的求助都能就地解决。
【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具，去水印，支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
