终端里为什么有一排豆腐块?5分钟搞定 Powerlevel10k 字体配置(Meslo Nerd Font 安装实操)
【免费下载链接】powerlevel10kA Zsh theme项目地址: https://gitcode.com/GitHub_Trending/po/powerlevel10k
刚装好 Powerlevel10k 这个 Zsh 主题——它能把你的终端提示符变成带 git 状态、当前目录、命令耗时信息的样子——结果一打开,提示符位置变成一排 □□□ 豆腐块。先说结论:这不是 bug,也不是主题坏了,是终端字体缺字形。解法就是装上 Powerlevel10k 作者专门打过补丁的 Meslo Nerd Font(也叫 MesloLGS NF),它把主题可能用到的图标字形全部塞进去了。
先诊断:确认是不是字体问题
装之前先看两个地方。第一看豆腐块出现的位置:通常就在图标该在的地方——git 分支符号、计时图标、提示符开头的小箭头。普通英文字母、数字、~和/都正常,只有图标变方块,那基本可以断定是字形缺失。第二看你终端当前用的什么字体:如果你从没装过任何 Nerd Font,那就是字体问题;如果装过别的 Nerd Font 但还是出方块,多半是那个字体补丁的字形没覆盖全,这种情况我还是建议直接换 MesloLGS NF,它是在各系统几十个终端里验证过的版本。
决策点:有没有能省事的快捷方式
动手前先排除一个问题:你用的是 iTerm2(macOS)还是 Termux(安卓)?如果是,后面手动流程全部跳过——在终端里跑p10k configure,向导问要不要安装 Meslo Nerd Font 时回答 Yes,字体下载和终端设置它都会替你做完,收工。
其他终端用户,走下面的手动流程。
手动安装:4 个字体文件,两步走
第一步,把字体装进系统。需要 4 个 TTF 文件:Regular(常规)、Bold(粗体)、Italic(斜体)、Bold Italic(粗斜体),四个都装上,提示符渲染粗体斜体时才不会缺字形。逐个双击、点安装之后,系统字体列表里会出现MesloLGS NF这个字体族。仓库根目录的 font.md 里有完整的字体说明和下载清单。
第二步,让终端用它。这一步只是把终端字体指过去,各家按钮位置不同,但目标一样——选中MesloLGS NF(个别终端里显示为MesloLGS NF Regular):
| 终端 | 配置位置 |
|---|---|
| iTerm2 | Preferences → Profiles → Text → Font |
| Apple Terminal | Preferences → Profiles → Text,点 Font 下的 Change |
| Windows Terminal | 设置(Ctrl+,)→ Appearance → Font face |
| Windows Console Host(老控制台) | 左上角图标 → Properties → Font |
| GNOME Terminal(Ubuntu 默认) | Preferences → 当前 profile,勾选 Custom font |
| Konsole | Edit Current Profile → Appearance → Select Font |
| VS Code 内置终端 | 设置里搜terminal.integrated.fontFamily填上 |
| Hyper / Alacritty / kitty | 配置文件里改fontFamily或font.normal.family |
特别提醒:VS Code 内置终端、JetBrains 系 IDE 的终端都不跟系统默认走,得单独设。
30秒验证 p10k 字体是否生效
设置完别盯着旧窗口看,把所有终端窗口关掉,开一个全新的。进任意 git 仓库目录看一眼提示符:箭头、分支图标、计时图标都显示成实体图形而不是方框,就成了。如果还有残留方块,一般是终端缓存了旧字体,重启终端即可;实在不行重启系统。
另外,换完字体建议再跑一次p10k configure,它会重新生成~/.p10k.zsh配置,挑出和新字体配套的最佳提示符风格,避免"字体对了、风格却没跟着调"。
图标还是不显示?按顺序排查两点
先核对字体名:回到终端的字体设置框,确认填的是MesloLGS NF,而不是没带 NF 后缀的MesloLGS,或者压根还是原来的Monaco、Consolas——这种情况是设置没保存成功。再核对改的作用范围:不少终端的"profile"和"默认"设置是分开的,你只改了一个 profile,新窗口可能还是走的默认配置,确保改的是你实际在用的那个。这两点排除后仍异常,可以去 README.md 的字体 FAQ 部分对一下。
最后一句可执行的建议:字体确认没问题后,再跑一遍p10k configure挑一个你喜欢的风格——那一步才是看到全部折腾成果的地方。
【免费下载链接】powerlevel10kA Zsh theme项目地址: https://gitcode.com/GitHub_Trending/po/powerlevel10k
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考