安装

相关源文件

• bin/scripts/lib/fonts.json
• readme.md
• readme_cn.md
• readme_es.md
• readme_fr.md
• readme_hi.md
• readme_it.md
• readme_ja.md
• readme_ko.md
• readme_pl.md
• readme_pt-pt.md
• readme_ru.md
• readme_tw.md
• src/unpatched-fonts/0xProto/0xProto-Bold.ttf
• src/unpatched-fonts/0xProto/0xProto-Italic.ttf
• src/unpatched-fonts/0xProto/0xProto-Regular.ttf
• src/unpatched-fonts/0xProto/README.md

本页面介绍了在您的系统上安装 Nerd Fonts 的各种方法。Nerd Fonts 使用来自流行图标库的大量字形（图标）修补面向开发者的字体，使其对开发者、终端用户和 Markdown 作者非常有用。有关创建您自己的修补字体的信息，请参阅 字体修补器。

安装概览

Nerd Fonts 提供了多种安装选项，以适应不同的操作系统、用户偏好和需求。选择最适合您需求的方法。

来源: readme.md34-48 readme.md205-412

下表总结了可用的安装选项

选项	描述	平台	最佳用途
1. 发布归档文件	完整的字体家族包	所有	需要多种变体（粗体、斜体等）的用户
2. Homebrew 字体	包管理器安装	macOS、Linux	熟悉 Homebrew 的 macOS 用户
3. Chocolatey/Scoop	Windows 包管理器	Windows	喜欢使用包管理器的 Windows 用户
4. Arch 仓库	Arch Linux 软件包	Arch Linux	Arch Linux 用户
5. PowerShell 安装程序	交互式/脚本化设置	Windows、macOS、Linux	希望进行引导式安装的用户
6. 即时 Curl 下载	单独字体下载	Linux、macOS	需要特定字体的命令行用户
7. 安装脚本	自动化安装	所有	希望通过脚本安装的用户
8. 字体回退	仅包含符号的字体	所有	只需要符号的用户
9. 克隆仓库	完整仓库访问	所有	贡献者或开发者
10. 字体修补器	自定义字体修补	所有	有自定义字体需求的用户

来源: readme.md34-48 readme.md70-89

安装过程

无论您选择哪种方法，一般的安装流程都遵循以下步骤

来源: readme.md205-412

选项 1: 发布归档文件下载

如果您想要包含所有变体（粗体、斜体等）的**完整字体家族**，这是推荐的选项。

1. 前往 latest release 页面
2. 下载您所需字体的归档文件（例如，JetBrainsMono.tar.xz）
3. 解压归档文件
4. 在您的系统上安装字体文件
   • Windows: 右键单击并选择“安装”或复制到 C:\Windows\Fonts
   • macOS: 双击字体文件或复制到 ~/Library/Fonts
   • Linux: 复制到 ~/.local/share/fonts 并运行 fc-cache -fv

用于脚本中的自动化下载

来源: readme.md211-221

选项 2: Homebrew 字体

适用于喜欢使用 Homebrew 的 macOS 用户

适用于使用 Homebrew 的 Linux 用户

来源: readme.md223-234

选项 3: Chocolatey 或 Scoop (Windows)

适用于喜欢使用包管理器的 Windows 用户

使用 Chocolatey

使用 Scoop

来源: readme.md235-250

选项 4: Arch Linux 仓库

适用于 Arch Linux 用户

来源: readme.md252-258

选项 5: PowerShell 安装程序

用于通过 PowerShell 进行 交互式设置 或 自动化

PSModule NerdFonts

PowerShell Web 安装程序

来源: readme.md259-298

选项 6: 即时 Curl 下载

用于使用 curl 命令 或在脚本中

Linux

macOS

注意：此方法不适用于访问较新的字体，因为它们不再存储在仓库中。

来源: readme.md299-318

选项 7: 安装脚本

用于 自动化安装 或在脚本中使用

注意：这需要（浅层）克隆仓库，并且不适用于访问较新的字体。

所有字体

或者，在 PowerShell 中（仅限 Windows）

单个字体

在 PowerShell 中（仅限 Windows）

来源: readme.md320-360

选项 8: 字体回退

适用于希望所有文本字体都使用 一个符号字体 的用户

大多数系统都有一个机制，当当前字体缺少所需字形时，会搜索替代字体。您可以为此目的使用其中一个 SymbolsOnly 字体。

对于基于 fontconfig 的系统，如 Linux，10-nerd-font-symbols.conf 配置文件可以改善行为（需要手动安装）。

优点：一个符号字体足以用于所有文本字体
缺点：回退符号的缩放和位置可能不一致

来源: readme.md362-374

选项 9: 克隆仓库

用于 完全控制 或 开发

不建议进行完整克隆，因为仓库过大，除非您正在为开发做贡献。如果您确实需要克隆，请使用浅层克隆

适用于不需要历史字体文件版本的开发者

仅克隆特定子目录

来源: readme.md375-400

选项 10: 修补您自己的字体

用于 自定义 或修补您自己的字体

1. 下载修补器:

2. 安装依赖项:

   • FontForge
   • Python 3
   • python-fontforge 和 argparse 软件包

3. 修补您的字体:

4. 使用 Docker

常用选项包括

• -s 或 --mono: 生成等宽字形 (Nerd Font Mono)
• --complete: 添加所有可用字形
• 要查看完整的选项列表，请运行 ./font-patcher --help

来源: readme.md402-460 readme.md541-557

系统特定安装说明

下载或生成字体文件后，您需要在系统上安装它们

Windows

• 右键单击字体文件并选择“安装”
• 或复制到 C:\Windows\Fonts

macOS

• 双击字体文件打开字体册 (Font Book)，然后点击“安装字体”
• 或复制到 ~/Library/Fonts 进行用户特定安装
• 或复制到 /Library/Fonts 进行系统范围安装

Linux

应用配置

安装后，配置您的应用程序以使用 Nerd Fonts

终端模拟器

• iTerm2 (macOS): 偏好设置 → 配置文件 → 文本 → 字体
• 终端 (macOS): 偏好设置 → 配置文件 → 文本 → 字体
• Windows Terminal: 设置 → 配置文件 → 外观 → 字体面
• GNOME Terminal: 编辑 → 偏好设置 → 配置文件 → 自定义字体
• Alacritty: 更新 alacritty.yml 中的 font.normal.family

文本编辑器

• VS Code: 将 "editor.fontFamily": "YourNerdFont" 添加到 settings.json
• Vim/Neovim: 将 set guifont=YourNerdFont:h12 添加到您的配置

可用字体家族

Nerd Fonts 包含 60 多个修补过的字体家族（基于流行的编程字体）。一些流行选项包括

• JetBrains Mono Nerd Font
• Hack Nerd Font
• FiraCode Nerd Font
• CascadiaCode (CaskaydiaCove) Nerd Font
• DejaVuSansMono Nerd Font
• SourceCodePro (SauceCodePro) Nerd Font

有关可用字体的完整列表，请参阅 readme.md114-186

来源: readme.md114-186 bin/scripts/lib/fonts.json1-1248

故障排除

如果您的 Nerd Fonts 安装遇到问题

1. 字体未在应用程序中显示:

   • 验证字体是否正确安装
   • 尝试刷新字体缓存：fc-cache -fv (Linux)
   • 重启您的应用程序或系统

2. 字形显示不正确:

   • 确保您选择了 Nerd Font，而不是原始字体
   • 验证您使用的字体名称是否正确（例如，“Hack Nerd Font”而不是“Hack”）
   • 尝试使用 Mono 和常规变体

3. 符号重叠或未对齐:

   • 尝试字体的 mono 变体（修补器中的 -s 选项）
   • 某些终端模拟器可能对连字和符号的处理方式不同

有关更详细的故障排除，请参阅 Wiki 常见问题与故障排除