1. 简介

在使用 Oh My Zsh + Powerlevel10k 时，正确的字体配置至关重要。Powerlevel10k 依赖 Nerd Fonts 扩展字体，以正确显示 Git 状态、分支、时间、图标等信息。

如果没有正确配置字体，你可能会看到 乱码、问号（?）、方块（□）或缺失的 Powerlevel10k 图标。

本指南将介绍 如何安装和配置终端字体，适用于 Linux（Ubuntu、CentOS、Arch）、macOS、Windows（CMD、PowerShell、Windows Terminal、WSL）。

---

2. 选择正确的字体

Powerlevel10k 官方推荐 使用 MesloLGS NF，因为它包含所有必要的 Nerd Font 字符。如果你希望使用其他 Nerd Font（如 FiraCode Nerd Font、JetBrains Mono Nerd Font），也可以按照本指南安装。

推荐的字体下载地址

官方 Powerlevel10k 字体下载：
🔗 MesloLGS NF 下载

如果你想使用其他 Nerd Font，可以访问：
🔗 Nerd Fonts 官方下载

---

3. 在 Linux 安装字体

3.1 手动安装 MesloLGS NF（适用于所有 Linux 发行版）

MesloLGS NF 提供 四种不同的字体变体，你可以根据自己的需求选择安装：

• Regular：普通字体，适用于大多数场景。
• Bold：加粗字体，用于强调文本。
• Italic：斜体字体，一般用于代码注释或特殊高亮。
• Bold Italic：加粗斜体，结合加粗和斜体效果。

通常，安装 Regular 版本就足够了，但如果你喜欢更丰富的字体样式，可以安装全部四种。

安装所有四种字体

mkdir -p ~/.local/share/fonts
cd ~/.local/share/fonts
wget -O "MesloLGS NF Regular.ttf" "https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Regular.ttf"
wget -O "MesloLGS NF Bold.ttf" "https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold.ttf"
wget -O "MesloLGS NF Italic.ttf" "https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Italic.ttf"
wget -O "MesloLGS NF Bold Italic.ttf" "https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Bold%20Italic.ttf"
fc-cache -fv

只安装 Regular 版本（推荐给普通用户）

mkdir -p ~/.local/share/fonts
cd ~/.local/share/fonts
wget -O "MesloLGS NF Regular.ttf" "https://github.com/romkatv/powerlevel10k-media/raw/master/MesloLGS%20NF%20Regular.ttf"
fc-cache -fv

3.2 使用包管理器安装字体

Ubuntu / Debian

sudo apt install fonts-powerline -y
sudo apt install fonts-firacode -y  # 可选

Arch Linux

sudo pacman -S nerd-fonts-fira-code

Fedora

sudo dnf install powerline-fonts

CentOS / RHEL（需要 EPEL 源）

sudo yum install epel-release -y
sudo yum install powerline-fonts

3.3 设置终端使用 Nerd Font（GNOME Terminal / KDE Konsole）

1. 打开终端。
2. 进入首选项（Preferences）。
3. 找到当前使用的配置文件（Profile）。
4. 取消勾选“使用系统字体（Use system font）”。
5. 选择“MesloLGS NF” 或其他 Nerd Font。
6. 重启终端。

---

4. 在 macOS 安装字体

4.1 使用 Homebrew 安装 Nerd Fonts（推荐）

brew tap homebrew/cask-fonts
brew install --cask font-meslo-lg-nerd-font

4.2 手动安装

1. 下载 MesloLGS NF：MesloLGS NF
2. 打开 .ttf 文件。
3. 点击“安装字体”。

4.3 配置 iTerm2 / macOS 终端

iTerm2 配置步骤：

1. 打开 iTerm2 → Cmd + , 进入 Preferences。
2. 进入“Profiles” → 选择你的 Profile。
3. 进入“Text” 选项卡。
4. 在“Font” 里选择 MesloLGS NF。
5. 重启 iTerm2。

macOS 默认终端配置：

1. 打开“终端”应用。
2. 进入“偏好设置” → “文本”选项卡。
3. 选择 MesloLGS NF 作为字体。
4. 重启终端。

---

5. Windows 配置字体

配置 Windows Terminal（推荐）
Windows Terminal（适用于 PowerShell、CMD、WSL）可以单独设置 Nerd Font。

1. 打开 Windows Terminal → 点击右上角 “▼” → 设置（Settings）。
2. 选择“默认配置文件（Default profile）” 或 你使用的 Shell（PowerShell、CMD、WSL）。
3. 进入“外观（Appearance）” 选项卡。
4. 找到“字体（Font face）”，选择 MesloLGS NF。
5. 点击“保存”，然后 关闭并重新打开 Windows Terminal。

如果设置正确，你应该可以看到 Powerlevel10k 图标正常显示。

配置 CMD 和 PowerShell
Windows 传统的 CMD 和 PowerShell 不支持 修改字体为 Nerd Fonts，建议使用 Windows Terminal 或 VS Code 终端 进行 Powerlevel10k 主题显示。

但如果你仍然希望在 PowerShell 中使用 Nerd Fonts，可以使用 ConEmu 终端模拟器：

1. 下载 ConEmu：🔗 ConEmu 官网
2. 安装后，打开 ConEmu → “Settings” → “Features” → “Main font”
3. 选择 MesloLGS NF，并点击 Apply。

配置 WSL（Windows Subsystem for Linux）

WSL（如 Ubuntu、Debian、Arch 等）运行在 Windows Terminal 内，因此你可以直接按照 Windows Terminal 的字体设置。

如果你使用的是 WSL 内部的 GNOME Terminal/Konsole，可以按照 Linux 终端的字体设置方式进行调整（见 Linux 配置指南）。

---

6. 配置 VS Code 终端字体

VS Code 终端默认不使用 Nerd Font，因此需要手动修改。

6.1 设置 VS Code 终端字体

1. 打开 VS Code。
2. 按 Ctrl + Shift + P，输入 settings.json 并选择 Preferences: Open Settings (JSON)。
3. 添加/修改以下内容：

{"terminal.integrated.fontFamily": "MesloLGS NF"
}

4. 保存并重启 VS Code 终端（Ctrl + Shift + ）。

6.2 通过 VS Code 设置界面修改（推荐）

1. 打开 VS Code。
2. 按 Ctrl + ,（快捷键打开设置）。
3. 在搜索框输入 terminal.integrated.fontFamily。
4. 找到 “终端 > 集成: 字体系列” 选项，输入 MesloLGS NF。
5. 关闭设置窗口，VS Code 终端将自动应用新字体。

---

6. 配置 JetBrains 系列 IDE（IDEA、PyCharm、WebStorm）

如果你在 JetBrains 系列 IDE（如 IntelliJ IDEA、PyCharm、WebStorm）中使用 Powerlevel10k，你需要配置 终端和编辑器的字体。

6.1 设置终端字体

1. 打开 IntelliJ IDEA（或 PyCharm、WebStorm）。
2. 进入 File → Settings → Editor → Color Scheme → Console Font。
3. 在“Font”里选择 MesloLGS NF。
4. 点击 Apply，然后 OK。

6.2 设置编辑器字体（可选）

1. 进入 File → Settings → Editor → Font。
2. 在“Font”里选择 MesloLGS NF（或其他 Nerd Font）。
3. 点击 Apply，然后 OK。

---

7. 验证字体是否正确

运行以下命令，检查 Powerlevel10k 字符是否正常显示：

echo "✓ Testing Powerlevel10k Icons:  ⚡ ❯"

如果显示 ✓  ⚡ ❯，说明字体正确 ✅。
如果仍然看到 ? 或 □，请确认：

• 终端已选择 MesloLGS NF 或其他 Nerd Font。
• 已正确安装字体，并刷新字体缓存（Linux：fc-cache -fv）。
• 在 iTerm2、Windows Terminal、macOS 终端等中选择了正确的字体。

---

8. 重新配置 Powerlevel10k（如果仍然有问题）

如果字体仍然异常，可以重新配置 Powerlevel10k：

p10k configure

按照向导重新调整字体和主题设置。

---

9. 总结

✅ 安装 Nerd Fonts，并正确配置终端。
✅ 适用于 Linux、macOS、Windows。
✅ 确保 Powerlevel10k 主题显示正确。

🚀 现在你的终端已经 完美适配 Powerlevel10k，开始享受高效美观的终端体验吧！