Starship「No Nerd Fonts」预设深度解析：不安装 Nerd Font 也能完整显示提示符图标

导读

Starship 的默认模块符号（Git、Node.js、Erlang、电池等）大量依赖 Nerd Font 字体中私有使用区（PUA）的图标字形。若终端环境没有安装 Nerd Font，这些符号会渲染成方块、空白或乱码。no-nerd-font 是 Starship 官方内置的一套预设（Preset），它把需要用到 Nerd Font 图标的模块符号统一替换为 emoji 与 Powerline 符号集中普遍可用的字符，从而保证在缺少 Nerd Font 的终端里提示符依然完整可读。本文以 docs/it-IT/presets/no-nerd-font.md 为主体，结合仓库内预设配置与源码，讲清该预设的使用方法、每项符号替换的含义以及背后的实现机制，读完后你将能通过一条命令让任何环境下的 Starship 提示符不再「缺字」。

一、预设解决的问题：Nerd Font 依赖与缺失场景

Starship 默认配置中有相当一部分模块符号来自 Nerd Font 字体集。以源码中的默认值为例，这些符号位于字体私有使用区，普通系统字体通常不包含它们：

• src/configs/battery.rs 中电池模块的默认符号 󰁹、󰂄、󰂃、󰂑、󰂎 均为 Nerd Font 字形；
• src/configs/azure.rs 的默认 󰠅、src/configs/nodejs.rs 的默认 、src/configs/pulumi.rs 的默认  同样如此。

一旦运行提示符的终端没有安装 Nerd Font，这些字符就无法被正确渲染。最常见的受影响环境包括：

• 通过 SSH 登录的远程服务器 / 容器（字体未同步安装）；
• 使用系统默认等宽字体的全新终端（如 Windows 的默认环境）；
• 团队共享一套 starship.toml，但无法要求每位同事都安装 Nerd Font。

这正是 no-nerd-font 预设的价值所在。如 docs/presets/README.md 所述，该预设「修改若干模块的符号，使提示符中任何位置都不再使用 Nerd Font 符号」，并且它会被应用于若干模块，让图标只落在 emoji 与 Powerline 两套字符集中——即便没有安装 Nerd Font，也能看到所有模块符号。

二、快速上手：一条命令应用预设

no-nerd-font 是 Starship 的内置预设，不需要手动下载任何文件，直接通过 starship preset 子命令输出即可：

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

执行后，预设内容会被写入 ~/.config/starship.toml。关于配置文件的默认位置，可参见仓库的 安装与配置指引：在 Linux/macOS 下通常即 ~/.config/starship.toml，Windows 下则位于 %USERPROFILE%\.config\starship.toml。

从源码看，preset 是 Starship CLI 的一个正式子命令。src/main.rs 中定义了 starship preset [name]，支持以 -o/--output 指定输出文件（默认输出到标准输出）、以 force 布尔参数控制是否允许覆盖目标文件，并可通过列表参数一次性打印出全部内置预设名。真正的写盘逻辑位于 src/print.rs 的 preset_command：它会先取内置预设的完整文本，再调用 write_file_atomic 做原子写入。因此，除了文档中的 -o 形式，你同样可以把输出重定向到任意文件：

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

给已有自定义配置的读者的提醒

starship preset 的语义是「把预设整段内容写入目标文件」，如果你的 ~/.config/starship.toml 里已有一套自己精心调过的配置，直接覆盖会全部丢失。建议先备份，再手工把下文解析出的符号键合并进现有文件：

cp ~/.config/starship.toml ~/.config/starship.toml.bak

三、预设内容逐项解析

no-nerd-font 对应的 TOML 文件位于 docs/public/presets/toml/no-nerd-font.toml，完整内容如下：

"$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 = "🧊 "

文件首行以 "$schema" 指向 Starship 的配置 JSON Schema，用于让编辑器获得配置项的校验与补全能力。文件只动了五个模块，含义如下：

1. [azure]：Azure 云模块

项	默认符号（Nerd Font）	预设后
symbol	󰠅（见 src/configs/azure.rs）	☁️ （emoji）

需要说明：Azure 模块在 Starship 默认配置中是默认禁用的（disabled: true，见 src/configs/azure.rs），预设在此处调整符号是为启用该模块的用户提前做好「无 Nerd Font」兜底。

2. [battery]：电池模块

电池模块是符号替换最密集的一个，五个状态各自对应一个默认字形（见 src/configs/battery.rs）：

配置键	语义	默认符号	预设后
full_symbol	电量充满	󰁹	•
charging_symbol	充电中	󰂄	⇡
discharging_symbol	放电中	󰂃	⇣
unknown_symbol	电量未知	󰂑	❓
empty_symbol	电量耗尽	󰂎	❗

这些符号会结合电池模块默认的 format（$symbol$percentage，见 src/configs/battery.rs）与阈值样式一起显示：例如电量低于 10% 时，默认以 red bold 样式强调（src/configs/battery.rs），而本预设只替换符号、不动样式，因此替换后仍能保留原有的色彩与阈值提示逻辑。

3. [erlang]：Erlang 模块

项	默认符号	预设后
symbol	（见 src/configs/erlang.rs）	ⓔ （带圆圈的小写 e）

ⓔ 属于「带圈字母数字」Unicode 区段，绝大多数系统字体都能直接渲染，替代了原先的 Nerd Font 专属字形。

4. [nodejs]：Node.js 模块

项	默认符号	预设后
symbol	（见 src/configs/nodejs.rs）	⬢

这里有一个值得注意的写法：预设不是简单替换成一个裸 emoji，而是借用了 Starship 配置中「带样式的符号」语法——⬢ 表示渲染黑色的六边形符号 ⬢（U+2B22，属于几何图形区段）并应用 bold green 样式。这说明 no-nerd-font 追求的不只是「能显示」，还包括尽量保持与默认 Nerd Font 图标相近的视觉观感（例如品牌绿）。

5. [pulumi]：Pulumi 模块

项	默认符号	预设后
symbol	（见 src/configs/pulumi.rs）	🧊 （冰块 emoji）

Pulumi 的云资源语义用「冰块」emoji 表达，直观且不需要额外字体。

小结：为什么只需改这几个模块

Starship 的大多数模块符号本身就是 ASCII 或通用 Unicode（比如 git 分支用 master 文本、目录用常规文字），真正落到 Nerd Font 私有区的只有少量模块。因此这份预设只需要精修上述五类符号，即可让整条提示符脱离对 Nerd Font 的依赖——这是「投入极小、收益全面」的设计。

四、源码侧验证：内置预设的加载与符号默认值

如果你好奇「这些替换到底有没有生效、默认符号到底是什么」，可以沿着两条路径在仓库中验证：

路径一：默认符号定义。 每个模块的默认符号都集中声明在 src/configs/ 目录下的对应 *Config::default() 实现里：

• symbol 字段：azure、erlang、nodejs、pulumi（本预设全部替换的正是这些 symbol 默认值）；
• 电池模块的五个 *_symbol 字段：见 src/configs/battery.rs。

路径二：预设如何被内置。 预设文本在编译期被嵌入二进制，运行时由 src/print.rs 中 Preset 结构包装的 shadow::get_preset_list() 提供候选列表，preset_command 再按名字取出内容写出（src/print.rs）。换言之，starship preset no-nerd-font 输出的内容与 docs/public/presets/toml/no-nerd-font.toml 保持同源一致，无需联网即可离线应用。

五、使用场景与注意事项

推荐使用场景：

• 远程主机 / 容器 / CI 环境中不便安装字体，但仍想保留信息量丰富的提示符；
• 需要向团队成员分发一份「零字体前置条件」的通用配置；
• 终端模拟器对 Nerd Font 私有区字形渲染不佳（如字符间距异常、退格对齐错乱）时，作为替代方案。

注意事项：

1. 覆盖前先备份：该命令会整体覆盖目标配置文件，请参考上文第三节的备份建议，或只把相关 [module] 段落合并进现有配置。
2. 它不改动你没有显式列出的模块：预设本质是若干 [section] 的片段组合，未涉及的模块仍沿用 Starship 内置默认符号；若你的配置中还自定义过其他模块的 Nerd Font 符号，需要自行评估是否保留。
3. emoji 依赖系统 emoji 字体：替换后的符号（如 ☁️、🧊、❓）要求系统存在相应的彩色 emoji / 普通符号字体。对绝大多数桌面发行版与 macOS、Windows 而言这不是问题，但对极精简的容器镜像仍可能缺字，可再叠加使用 纯文本符号预设 做进一步降级。
4. 未来会成为默认：文档明确写到该预设「将在 Starship 的未来版本中成为默认预设」，这是项目给出的路线图预期（本仓库当前版本的默认配置仍以 Nerd Font 符号为准），迁移到新版本时留意 CHANGELOG 即可。

六、相关预设与延伸阅读

no-nerd-font 只是 Starship 预设集 中的一员，与它定位互补的还有：

• Nerd Font Symbols 预设：与本文相反，把各模块符号统一改为 Nerd Font 字形，适合已装好 Nerd Font 的用户；
• Plain Text Symbols 预设：把符号改成纯文本（甚至无需 Unicode），适合 ASCII-only 终端。

另外，本文档 docs/it-IT/presets/no-nerd-font.md 是英文原版 docs/presets/no-nerd-font.md 的多语言副本之一，仓库中每个语言目录（ar-SA、zh-CN、ja-JP 等）都维护了对应的翻译版本；技术内容以英文原版与 预设 TOML 为准。想要进一步了解如何手动调整某个模块的 symbol 及如何把符号包上颜色样式（如 ⬢），可继续阅读 Starship 配置指南 与 高级配置。