Powerlevel10k 字体配置：4 个字重 + 终端设置，3 步告别方块乱码，终端美化一步到位

Powerlevel10k 字体配置：4 个字重 + 终端设置，3 步告别方块乱码，终端美化一步到位

【免费下载链接】powerlevel10kA Zsh theme项目地址: https://gitcode.com/GitHub_Trending/po/powerlevel10k

刚给 Zsh 换上 Powerlevel10k 的那一刻，你多半见过这样的画面：提示符左边的箭头变成了一个空心方块，git 分支图标变成了一串问号，~旁边的彩色段全塌成了□□。这就是典型的字体配置没跟上——主题本身没问题，缺的是一套能画出这些符号的字体。把 Meslo Nerd Font 装好并写进终端，乱码会在几分钟内全部消失。

乱码是怎么来的：Nerd Font 解决的只是一个字符表问题

Powerlevel10k 的箭头、锁、git 图标用的都是私有区（PUA）码位上的特殊符号，系统默认字体里根本没有这些字形，终端只能画出"豆腐块"。Nerd Font 这类等宽字体做的事情很简单：在成熟等宽字体（这里是 Meslo）上把所需图标字形补进去，一个字体同时解决符号显示和等宽对齐。

装字体的两条路：一键和手动

一键自动：让 p10k configure 替你下

如果你用的是 iTerm2 或 Termux，直接运行p10k configure，在"是否安装 Meslo Nerd Font"的提问里选Yes，✅ 下载、安装、选字体会一次完成，不用打开任何设置面板。

手动下载：4 个字重一个都不能少

其他终端走手动路线，按顺序做：

1. 找到 Powerlevel10k 官方提供的 MesloLGS NF 字体文件，共 4 个变体：Regular、Bold、Italic、Bold Italic。
2. 逐个双击 ttf 文件（或用系统字体管理器导入），点击"安装"，让MesloLGS NF对系统内所有应用可见。
3. 到终端里把字体设为MesloLGS NF（各终端路径见下一节）。

字体细节可以在仓库的 font.md 里查到完整背景。

各终端里把字体设为 MesloLGS NF 的具体位置

下面按工具逐个给路径，全部只需改"Font / 字体"这一个字段，值统一填MesloLGS NF：

iTerm2

1. 打开 Preferences → Profiles → Text。
2. 在 Font 一栏选择MesloLGS NF。

Apple Terminal（macOS 自带）

1. Terminal → Preferences → Profiles → Text。
2. 点 Font 下方的 Change，选中MesloLGS NF字体族。

Windows Terminal

1. Ctrl+,打开 Settings，选中目标 profile 或 Defaults。
2. 点 Appearance。
3. Font face 设为MesloLGS NF。

GNOME Terminal（Ubuntu 默认终端）

1. Terminal → Preferences，选中当前 profile。
2. Text Appearance 下勾选 Custom font。
3. 选择MesloLGS NF Regular。

Visual Studio Code 内置终端

1. File → Preferences → Settings。
2. 搜索框输入terminal.integrated.fontFamily。
3. 把值改成MesloLGS NF。

Alacritty

1. 打开~/.config/alacritty/alacritty.toml。
2. 在[font.normal]段下写family = "MesloLGS NF"，保存后重开终端。

WezTerm

1. 打开wezterm.lua（或wezterm.lua对应的配置路径）。
2. 把font数组第一项设为{ family = "MesloLGS NF" }。
3. 执行wezterm cli reload-config或重启终端。

验证生效，并把三个高频坑一次排掉

改完先开一个新标签页看提示符：箭头、git 图标、彩色段都应完整渲染。确认没问题后运行一次p10k configure，它会重新生成~/.p10k.zsh，把新字体环境写进配置。💡

排错时按这几点查，基本覆盖九成问题：

1. 终端缓存了旧字体：很多终端（尤其 Konsole、kitty）修改字体后要重开标签页甚至重启进程才生效，改完先开新会话再判断。
2. 设置里其实没选上 Meslo：部分终端有多个 profile，你改的是 A 档而窗口在跑 B 档；核对当前 profile 的字体名是否真是MesloLGS NF。
3. 字重不全导致"斜体变假斜"或粗体发虚：只装了 Regular 的话，加粗和斜体会由终端伪造，观感割裂——回到手动安装的 4 个文件补齐字重即可。

更底层的机制可以看主题入口 powerlevel10k.zsh-theme，但日常配置基本用不上。

把字体这一步补上，Powerlevel10k 的提示符会立刻从"能用的 ASCII 堆"变成图标、色彩、分支状态一目了然的完整视觉系统——终端美化的最后一块拼图就此到位。

【免费下载链接】powerlevel10kA Zsh theme项目地址: https://gitcode.com/GitHub_Trending/po/powerlevel10k