Starship "No Nerd Font" 预设全解：不安装 Nerd Font 也能完整渲染全部模块符号

Starship 的提示符默认依赖部分 Nerd Font 字形，而"No Nerd Font"预设把所有模块符号收敛到 emoji 与 powerline 两个字符集，从而在没有安装 Nerd Font 的终端中也能完整、无"豆腐块"地显示提示符。本文围绕 docs/bn-BD/presets/no-nerd-font.md 展开，讲解该预设的定位、一行命令的启用方式、每一处符号替换的含义，并结合仓库中的配置实现与 CLI 源码（src/main.rs 与 src/print.rs）解释预设从哪来、如何被写入用户配置，帮助你在服务器、容器、远程 SSH 等无法或不愿安装特殊字体的场景下稳定使用 Starship。

一、该预设解决什么问题

Nerd Font 通过"打补丁"的方式，把大量图标字形塞进 Unicode 的私有使用区（Private Use Area），因此只有在终端里安装了对应 Nerd Font 字体后，这些字形才能被正确渲染。Starship 是"minimal、极速、可无限定制"的跨 Shell 提示符，它对符号的默认取值横跨多个字符集；在未安装 Nerd Font 的终端里，那些位于私有使用区的默认符号会退化成空框或乱码。

"No Nerd Fonts"预设正是为此而设计的：

• 它将符号的使用范围限制在 emoji 与 powerline 两个字符集内；
• 因此即便没有安装任何 Nerd Font，提示符中的全部模块符号仍然可以正常显示；
• 官方文档同时声明，该预设将在未来某个版本中成为 Starship 的默认预设。

预设全集与入口在 docs/presets/README.md，同一份文档还提供了中文翻译版 docs/zh-CN/presets/no-nerd-font.md 以及本次依据的孟加拉语版 docs/bn-BD/presets/no-nerd-font.md，各语言版本内容一致。

二、启用方式：一行命令写入配置

官方文档给出的启用命令极其简洁：

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

命令执行后，预设中记录的符号覆盖会被写入 ~/.config/starship.toml，重新打开或执行 source 后立即生效。命令的完整用法可以从 starship preset --help 获得，它对应的 CLI 参数定义在 src/main.rs，关键选项如下：

选项	含义
-o, --output <文件>	把预设内容输出到指定文件而非标准输出
-f, --force	目标文件已存在时强制覆盖（须与 -o 配合）
-l, --list	列出所有可用预设名称

实际执行时，src/main.rs 会把控制流转交给 src/print.rs 中的 preset_command：先取到与预设名称对应的完整 TOML 文本，再通过原子写文件工具 utils::write_file_atomic 写入目标路径，从而避免写到一半进程被中断导致配置损坏。仓库还内置了相应的单元测试（见 src/print.rs），其中 preset_command_does_not_panic_on_correct_inputs 会对每一个预设变体逐一执行、确保都能正常输出，而 preset_command_output_to_file 则校验写出内容与 include_str! 嵌入的预设源文件完全一致。

变体用法与注意事项

• 先预览再决定：不带 -o 执行 starship preset no-nerd-font，预设内容会直接打印到标准输出，方便在落地前确认。
• 查看可用预设：starship preset --list 会列出内置的全部预设名称（实现见 src/print.rs 的 preset_list）。
• 覆盖已有配置：如果你已经自定义过 starship.toml，-o 的写文件操作会直接覆盖目标文件，建议先备份已有配置或用 -f 之前自行 merge 所需片段；文档示例默认落在 ~/.config/starship.toml，若 Starship 配置路径不同（如设置了 STARSHIP_CONFIG），请替换为实际路径。
• 手动生效方式：如果不便执行 CLI，也可以直接从 docs/public/presets/toml/no-nerd-font.toml 复制内容拼入自己的 starship.toml。

三、预设文件逐项拆解

预设的源文件位于 docs/public/presets/toml/no-nerd-font.toml，构建期通过 include_str! 嵌入二进制，运行时再被 preset_command 取出。完整内容如下：

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

可以看到，预设只覆盖了五个模块：azure、battery、erlang、nodejs、pulumi。由该文件的内容可以推断，其余模块的默认符号本身就已属于 emoji、powerline 或常规 Unicode 字符，无需调整；唯独这五处默认取值存在落入私有使用区、必须依赖 Nerd Font 才能显示的情况。各模块默认符号定义在对应配置结构的 default() 实现中（目录 src/configs），替换对照如下：

模块	符号配置项	内置默认取值（源码确认）	No Nerd Font 替换值
azure	symbol	由 src/configs/azure.rs 的默认结构提供	☁️ （emoji 云朵）
battery	full_symbol	󰁹 （见 src/configs/battery.rs）	• （powerline 圆点）
battery	charging_symbol	󰂄	⇡ （向上箭头）
battery	discharging_symbol	󰂃	⇣ （向下箭头）
battery	unknown_symbol	󰂑	❓ （emoji 问号）
battery	empty_symbol	󰂎	❗ （emoji 感叹号）
erlang	symbol	 （见 src/configs/erlang.rs）	ⓔ （带圈的 e）
nodejs	symbol	 （见 src/configs/nodejs.rs）	⬢ （加粗绿色的 ⬢ 几何符号）
pulumi	symbol	由 src/configs/pulumi.rs 的默认结构提供	🧊 （emoji 冰块）

几个值得注意的细节：

• battery 是改动最完整的模块：它一次替换了五个状态符号（满电、充电、放电、未知、空电），因为在默认配置里这五处恰好都使用了 Nerd Font 私有使用区字形。替换后 battery 模块的状态表达依然清晰：• 表示满电、⇡ 表示正在充电、⇣ 表示放电中、❓ 表示未知、❗ 表示电量耗尽。
• nodejs 的符号还内嵌了样式：⬢ 是 Starship 的样式语法，表示把 ⬢ 渲染为粗体绿色。这说明符号配置项不仅可以放字符，也可以带上颜色/字体效果，渲染时由 Starship 的格式化引擎解析。
• 文件顶部的 "$schema" 指向 Starship 的 JSON Schema，仅为编辑器提供配置补全与校验提示，不影响运行时行为。

四、从源码看预设机制的运作方式

把上面的文档行为落到源码层面，会发现整条链路非常清晰：

1. 预设内容以 TOML 源文件形式维护在 docs/public/presets/toml 目录下，与文档同仓维护，方便贡献者直接对比与评审。
2. 构建时嵌入：编译期通过 include_str!("../docs/public/presets/toml/...toml") 将源文件内容写进二进制（见 src/print.rs 的测试断言）。由于预设文本不依赖运行时文件系统，任何机器上执行 starship preset 都能拿到一致内容。
3. 命令行分派：Preset 子命令由 clap 解析，参数被送入 src/print.rs 的 preset_command，最终调用原子写文件工具输出到 ~/.config/starship.toml 或 stdout。
4. 与默认配置结构的关系：预设并不是替换整套配置，而是只写入少数几个 symbol 覆盖项；其余参数（format、style、disabled 等）继续使用各模块配置结构 default() 中的内置值（如 src/configs/nodejs.rs 定义了 format、version_format、style、检测扩展名等）。这正是 Starship"配置覆盖默认值"这一通用机制的具体体现。

值得对照的是与它"方向相反"的姊妹预设 Nerd Font Symbols（源文件 docs/public/presets/toml/nerd-font-symbols.toml，介绍见 docs/presets/nerd-font.md）。那份预设把 aws、azure、git_branch、os.symbols（各发行版 Logo）、python、rust 等几乎所有模块的符号都替换成 Nerd Font 字形，覆盖范围远大于 no-nerd-font；而 no-nerd-font 只在必要处做"反向修补"。两者对比可以直观看出：Starship 允许你按字符集偏好，整体向左（全部 Nerd Font）或向右（只用 emoji/powerline）调整。

五、适用场景与落地建议

• 远程服务器 / SSH / Docker 容器：这些环境往往无法安装字体，是最典型的适用场景。配合文档预设页（docs/presets/README.md）中的 No Nerd Fonts 条目使用即可。
• 需要在多台机器间同步配置：由于启用命令只产生一份 TOML，内容完全确定且无外部依赖，非常适合放进 dotfiles 仓库统一管理。
• 未来兼容性：文档明确该预设将成为未来版本的默认预设，因此提前启用不仅解决当下显示问题，也让你更平滑地跟上 Starship 的默认行为演进（仓库 CHANGELOG.md 中也记录了该预设的引入与更新记录）。
• 恢复默认：若之后想在特定机器换回当前内置默认符号，只需删除或备份被覆盖的 symbol 行，重启 Shell 即可回退，因为未显式配置的模块会自动取用内置 default() 值。

总体而言，No Nerd Font 预设用极小的改动面（五个模块的十余个符号项）消除了最大的显示隐患，是 Starship 在"任何 Shell、任何终端环境"下保持极简、美观这一设计哲学的关键补充；理解它覆盖了哪些默认值、又为何只覆盖这些，也能帮你更清楚地掌握 Starship "内置默认 + 配置文件覆盖"的整体配置模型。