Starship No Nerd Fonts 预设实战：不安装 Nerd Font 也能完整渲染提示符符号

Starship 官方社区预设（Preset）体系中的 No Nerd Fonts 预设，专门解决"终端没有安装 Nerd Font 字体时，提示符符号出现乱码/方框"这一常见痛点。本文以仓库中对应的预设说明文档为主线，结合 no-nerd-font.toml 配置与 src/configs/* 中各模块的默认符号源码，完整讲解该预设的符号替换规则、单条命令应用方式以及验证方法。读完本文，你将能在一分钟内让 Starship 提示符摆脱对 Nerd Font 的依赖，并理解预设文件背后"模块默认 symbol → 渲染字形"的实现原理。

为什么需要"无 Nerd Font"预设：符号与字体的依赖关系

Starship 的每个模块（module）默认都会携带一个 symbol，例如 git 分支、Node.js、电池电量等模块在提示符中都有各自专属图标。这些默认图标并非全部来自标准的 Unicode 字符集，相当一部分落在字体的私有使用区（Private Use Area），必须由 Nerd Font 这类合成了大量图标的字体才能正确渲染。从本仓库各模块的默认配置可以清楚看到这一点：

• Node.js 模块默认符号 " "，见 src/configs/nodejs.rs；
• Erlang 模块默认符号 " "，见 src/configs/erlang.rs；
• Pulumi 模块默认符号 " "，见 src/configs/pulumi.rs；
• Azure 模块默认符号 "󰠅 "，见 src/configs/azure.rs；
• 电池模块的满电/充电/放电/未知/空电五态默认符号分别为 "󰁹 " "󰂄 " "󰂃 " "󰂑 " "󰂎 "，见 src/configs/battery.rs。

这些字形若终端字体不支持，显示结果就会是"豆腐块"（tofu）或错位字符。换句话说，采用模块默认配置的 Starship，通常要求终端启用一款 Nerd Font（或至少一款覆盖对应码位的字体）。

需要注意：并非所有默认符号都依赖 Nerd Font。例如 git 分支模块的默认符号 " "（见 src/configs/git_branch.rs）属于 powerline 符号区，只要安装了 powerline 类字体即可正常显示。No Nerd Fonts 预设正是抓住这一点：把符号统一收敛到 emoji 与 powerline 两个集合，从而彻底取消对 Nerd Font 的硬依赖。

No Nerd Fonts 预设是什么

按英文原版说明文档 docs/presets/no-nerd-font.md（本仓库同时提供了多语言翻译版本，如 docs/ckb-IR/presets/no-nerd-font.md），该预设的核心主张有三条：

1. 将提示符中使用的符号限制为来自 emoji 集合与 powerline 集合的字符；
2. 因此即使没有安装 Nerd Font，也能正常查看全部模块符号；
3. 该预设计划在 Starship 的未来版本中成为默认预设——这一表述同样出现在预设总览 docs/presets/README.md 中 No Nerd Fonts 条目的 TIP 提示里，属于官方明确规划，值得提前适配。

在预设总览页中，该预设被描述为"修改了若干模块的符号，使提示符中任何位置都不再出现 Nerd Font 符号"。它并不是把所有符号删除或改写成纯文本，而是逐模块挑选语义等价的通用字符进行替换。

预设 TOML 逐项解析

No Nerd Fonts 预设的全部内容就是一份精简 TOML 配置，权威文件位于 docs/public/presets/toml/no-nerd-font.toml，同时也是 docs/presets/no-nerd-font.md 中内嵌展示的配置正文：

"$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 键：声明该 TOML 遵循 Starship 配置的 JSON Schema（对应的 Schema 发布物为 docs/public/config-schema.json），配合支持 Schema 的编辑器可获得自动补全与校验提示。它不影响运行时行为。

这份预设是"最小差异补丁"而非全量配置：文件只包含需要改动的 5 个模块条目，其余模块保持内置默认值。也就是说，凡是默认符号已属于 emoji/powerline/通用 Unicode 的模块（例如 git 分支的 " "），预设都不会去触碰。

下面逐个模块对照替换前后关系：

模块	替换前默认 symbol（源码默认值）	替换后	说明
[azure]	"󰠅 "（私有区字形，见 src/configs/azure.rs）	"☁️ "	Azure 订阅信息提示，改用云朵 emoji；该模块默认 disabled: true，仅在用户显式启用后生效
[battery]	五态字形 "󰁹 " "󰂄 " "󰂃 " "󰂑 " "󰂎 "（见 src/configs/battery.rs）	"• " "⇡ " "⇣ " "❓ " "❗ "	满电/充电/放电/未知/空电分别改用实心圆点、上下箭头与 emoji，均在普通字体与 powerline 中可用
[erlang]	" "（见 src/configs/erlang.rs）	"ⓔ "	Erlang 语言标识改用带圈的字母 ⓔ
[nodejs]	" "（见 src/configs/nodejs.rs）	"⬢ "	Node.js 标识改为六边形 ⬢，并借 Starship 的 format 字符串语法内联声明 bold green 样式
[pulumi]	" "（见 src/configs/pulumi.rs）	"🧊 "	Pulumi 栈提示改用冰块 emoji

其中 [nodejs] 的替换值值得单独说明：symbol 字段本身就是一个 Starship format 字符串，⬢ 中括号包裹的是要显示的文字，紧随其后的圆括号内是样式声明，这与 format 字段共用同一套字符串格式化语法。因此该预设不只是在换图标，还顺手为 Node.js 符号指定了加粗绿色，替代原先通过字形隐含的视觉辨识度。

应用预设：命令、输出与落盘机制

一条命令写回默认配置文件

按文档（含各语言翻译版，如 docs/ckb-IR/presets/no-nerd-font.md）提供的标准用法：

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

-o 指定输出目标文件，命令会把预设内容写入该路径。若目标文件已存在且未使用强制覆盖参数，写入会因存在冲突而中止，这是由 src/print.rs 中 preset_command 的 force 参数与原子写文件逻辑决定的。

先预览再落地：输出到标准输出

preset_command 在未指定 -o 时会把预设内容直接打印到标准输出（见 src/print.rs），因此你可以在真正写盘之前先预览：

starship preset no-nerd-font

甚至配合 shell 重定向输出到任意位置（例如先存成临时文件审阅后再替换正式配置）：

starship preset no-nerd-font > /tmp/no-nerd-font.toml

查看可用的预设列表

Starship 还提供列出全部内建预设名的能力：preset 子命令支持 list 分支，preset_list() 会逐行打印可用的预设名（见 src/print.rs），运行类似 starship preset --list 即可看到包含 no-nerd-font 在内的全部预设。

背后机制：预设文件被编译进二进制

从源码看，Preset 枚举的候选名单与内容均由内嵌数据提供：Preset::value_variants() 调用 shadow::get_preset_list()，preset_command 通过 shadow::get_preset_content(name) 获取内容（src/print.rs）；测试中则直接以 include_str!("../docs/public/presets/toml/nerd-font-symbols.toml") 方式比对输出（见 src/print.rs）。也就是说，docs/public/presets/toml/ 目录下的 TOML 就是各预设的单一事实来源，随编译打包进 Starship 可执行文件，执行 preset 命令时并不需要联网下载。

与已有自定义配置的关系

-o 是整体写入：预设生成的是"最小差异"的独立 TOML，如果你当前的 ~/.config/starship.toml 里已有大量自定义内容，直接覆盖会丢失它们。安全做法是：

1. 先备份：starship preset no-nerd-font -o ~/.config/starship.toml.bak（或自行复制原文件）；
2. 将预设 TOML 中的五个 [module] 段落手工合并进现有配置；
3. 或先输出到临时文件审阅差异后，再决定如何合并。

由于这份预设本来就只含 5 个模块的 symbol 覆盖，合并成本很低。若想撤销预设，只需删除 starship.toml 中新增的 [azure] [battery] [erlang] [nodejs] [pulumi] 相关段落，符号即恢复为内置默认值。

如何验证"没有 Nerd Font 也能正常显示"

应用预设后，建议做以下验证：

1. 将终端字体切换为一款不含 Nerd Font 字形的普通等宽字体（如系统自带的 Monospace / Menlo / Consolas 等），或临时卸载 Nerd Font；
2. 进入一个包含 .git 的目录、同时能触发 Node.js 与 Python 等模块的环境，检查 git 分支、Node 版本等符号是否仍然清晰显示；
3. 若机器有电池（笔记本），可打开电池模块观察 • ⇡ ⇣ 等符号渲染是否正常。

如果上述环境中的符号不再出现豆腐块或乱码，即说明预设生效。

与其它符号类预设的对比与选型

在官方预设集合（总览见 docs/presets/README.md）中，符号取向相关的预设还有两个，容易混淆，此处一并厘清：

• Nerd Font Symbols：方向恰好相反，把各模块符号统一改成 Nerd Font 字形，以最大化视觉效果，前提是终端安装了 Nerd Font。如果你没有安装或不愿安装 Nerd Font，应选择 No Nerd Fonts。
• Plain Text Symbols：把模块符号全部改写成纯 ASCII/纯文本（例如 [rust] 样式），适合连 Unicode 都无法可靠显示的环境。No Nerd Fonts 的定位介于两者之间——保留 emoji 与 powerline 的图形化表达，但放弃 Nerd Font 专属字形。

三条路线的取舍可以概括为：能装 Nerd Font 追求观感选 nerd-font；完全无字体限制选 no-nerd-font；极端环境只求不坏选 plain-text。由于官方已明确 No Nerd Fonts 将成为未来版本的默认预设，从现在起采用它可以最大程度降低将来升级时的提示符外观波动风险，值得提前迁移。