Starship 的 no-nerd-font 预置配置：不安装 Nerd Font 也能完整渲染提示符图标

2026-09-08 18:03:01作者：鲍丁臣Ursa

本文围绕 Starship 官方预置配置（preset）中的 No Nerd Fonts（对应文档 docs/nl-NL/presets/no-nerd-font.md 及其英文原文 docs/presets/no-nerd-font.md）展开，讲解它解决什么问题、替换了哪些模块符号、如何用一条命令应用，以及背后的源码依据。读完本文，你将掌握该预置配置的完整 TOML 内容、starship preset 子命令的用法，并理解 Nerd Font 符号与普通 Unicode 符号的差异，从而能够在终端未安装 Nerd Font 的环境下让 Starship 提示符保持完整可读。

No Nerd Fonts 预置配置要解决什么问题

Starship 是一个跨 Shell 的极简命令提示符。为了让各语言、工具模块具备高辨识度的图标，它的默认配置为不少模块选用了 Nerd Font 字体私有区（Private Use Area）中的符号。Nerd Font 通过对字体打补丁，把大量图标符号编入 Unicode 私有区，因此只有安装了 Nerd Font 字体的终端才能正确显示这些字符；在普通字体下，它们会退化成方块或乱码。

No Nerd Fonts 预置配置的做法非常直接：把提示符中所有符号限制为 emoji 与 powerline 两个字符集。文档原文说明了它的承诺：

This preset restricts the use of symbols to those from emoji and powerline sets. This means that even without a Nerd Font installed, you should be able to view all module symbols.

也就是说，应用该预置后，即使终端只装有常规字体（含 emoji 回退），所有模块符号也应能正常显示。

它到底改了什么：一份极精简的覆盖配置

No Nerd Fonts 预置的核心就是一个很小的 TOML 增量文件：docs/public/presets/toml/no-nerd-font.toml。它不是一套从零开始的新主题，而是只覆盖了默认使用 Nerd Font 私有区字符的几个模块的 symbol，其余全部沿用 Starship 默认配置。完整内容如下：

"$schema" = 'https://starship.rs/config-schema.json'

[azure]
symbol = "☁️ "

[battery]
full_symbol = "• "
charging_symbol = "⇡ "
discharging_symbol = "⇣ "
unknown_symbol = "❓ "
empty_symbol = "❗ "

[erlang]
symbol = "ⓔ "

[nodejs]
symbol = "⬢ "

[pulumi]
symbol = "🧊 "

要点拆解：

文件首行声明了 JSON Schema 地址，帮助编辑器对 Starship 配置做语法校验与补全。
[azure]、[erlang]、[nodejs]、[pulumi] 分别把各自的 symbol 换成 emoji 或通用 Unicode 字符。
[battery] 一次性覆盖了电池模块的五种状态符号：full_symbol、charging_symbol、discharging_symbol、unknown_symbol、empty_symbol。
[nodejs] 的写法最特别，symbol 不仅替换字符，还通过 ⬢ 这种 Starship 样式语法给它附加了 bold green 样式，保持与原版视觉一致性。

模块默认符号对照：从源码看替换动机

为什么偏偏是这几个模块需要覆盖？因为它们在 src/configs/ 下的默认配置都直接硬编码了 Nerd Font 私有区字符。以下是仓库源码中的默认值与预置替换后的对照：

模块	默认 `symbol`（源码）	预置替换值
azure	`󰠅` （见 src/configs/azure.rs）	`☁️` （emoji）
nodejs	`` （见 src/configs/nodejs.rs）	`⬢` （几何图形）
erlang	`` （见 src/configs/erlang.rs）	`ⓔ` （带圈字母，近似"Erlang 之 e"）
pulumi	`` （见 src/configs/pulumi.rs）	`🧊` （emoji）
battery（full）	`󰁹` （见 src/configs/battery.rs）	`•` （powerline/bullet）

从源码可以推断替换选择的逻辑：󰠅、、、、󰁹 等字符均落在 Nerd Font 打补丁引入的私有区码段，普通字体无法渲染；而 ☁️、⬢、ⓔ、🧊、•、⇡、⇣、❓、❗ 都属于常见 Unicode 区块或 emoji 标准，绝大多数终端字体都能覆盖。文档中强调的"限制为 emoji 与 powerline 集合"，正是针对私有区字符的规避策略。

需要说明的是，该预置默认不会调整 Git、目录等大量模块的符号，因为这些模块在 Starship 中本就使用 ASCII 或常规 Unicode 符号，不受 Nerd Font 缺失影响。

应用方式：一条命令装好预置配置

原文档给出的安装命令非常简洁：

starship preset no-nerd-font -o ~/.config/starship.toml

命令含义如下：

starship preset：Starship 内置的预置配置子命令，负责输出或写入某个内置 preset；
no-nerd-font：要使用的预置名称；
-o ~/.config/starship.toml：把生成的 TOML 内容直接写入用户级配置文件（即 Starship 的主配置文件路径）。

从源码实现看，该子命令的入口定义在 src/main.rs，真正的执行逻辑在 src/print.rs：它从内嵌的预设文件中读出 TOML 内容，再按用户指定的目标输出。你可以先用下面几种方式预览内容，确认无误后再写入配置文件：

# 直接打印到终端，供检查
starship preset no-nerd-font

# 列出所有内置 preset 名称，确认 no-nerd-font 存在
starship preset --list

如果目标配置文件已经存在，覆盖写入会要求使用 force 相关的选项（src/print.rs 的测试用例 preset_command_output_existing_file_force 即覆盖了这一场景）；否则可以先备份原配置：

cp ~/.config/starship.toml ~/.config/starship.toml.bak
starship preset no-nerd-font -o ~/.config/starship.toml

写入后，在已加载了 Starship 初始化脚本的 Shell 中新开一个终端窗口即可看到效果；若提示符未更新，可执行 exec $SHELL 或按所用 Shell 的方式重新加载配置。

已有自定义配置时：请手动合并而非整体覆盖

需要特别提醒：starship preset ... -o ~/.config/starship.toml 的语义是"把预设内容整体写入主配置文件"。如果你此前已经手工编写了大量自定义内容（自定义 format、Git 状态样式、自建 [custom.*] 模块等），直接执行上述命令会用预设的极小配置覆盖掉整个文件，造成自定义内容丢失。

正确的做法是把预设 TOML 中 [azure]、[battery]、[erlang]、[nodejs]、[pulumi] 这几个小节合并进你现有的 ~/.config/starship.toml（若原文件已有同名小节，则只需补充或修改其中的 symbol 字段）。Starship 采用分层合并的配置语义，缺少的键会回退到默认值，因此追加这几个小节不会影响其他模块。

若你使用的是 Windows，将 ~/.config/starship.toml 替换为系统对应的用户配置路径即可，命令其余部分不变。

验证与排障

应用预置后，可用以下方式验证是否真的"不依赖 Nerd Font"：

将终端字体切换为系统常规字体（如系统默认 sans-serif/monospace，不含 Nerd Font 补丁）；
触发会显示上述模块的场景，例如：进入 Azure/Node.js/Erlang/Pulumi 项目目录以显示对应语言符号，拔插电源或查看电量以显示电池符号；
肉眼确认各符号不再显示为方块（豆腐块）或乱码。

需要留意一个边界：该预置只保证所覆盖模块的符号脱离 Nerd Font 依赖；emoji 字符本身仍需要终端具备 emoji 字形支持。如果你的终端/字体连基本 emoji 都无法渲染，本预置无法彻底解决该问题，此时可考虑同一 preset 系列中的 Plain Text Symbols（全部转纯文本符号）或 No Empty Icons 等其他预置。

未来会怎样：成为默认配置的可能性

原文档与 Presets 索引页均说明：该预置计划在未来某个版本的 Starship 中成为默认 preset（docs 页面中关联了对应讨论/PR）。换言之，当前仓库各模块的默认符号仍以 Nerd Font 私有区字符为主，若你希望现在就开始体验"无 Nerd Font 化"的默认观感，提前应用本预置是一种低成本的前瞻性做法。