应先执行starship preset nerd-font-symbols命令启用预设，再验证nerd font是否被终端正确识别并设置为默认字体，最后用starship self-test确认图标渲染通过；若失败则回退至no-nerd-font预设。
如果您已安装Nerd Font但Starship提示符中图标仍显示为方块或乱码，则可能是预设未正确启用或字体未被终端识别。以下是应用Nerd Font Symbols预设的具体操作路径：
一、通过starship preset命令一键启用
Starship内置官方预设管理器，可直接调用nerd-font-symbols预设并写入配置文件，无需手动编辑TOML内容。该方式确保符号路径、样式与模块结构完全匹配官方验证版本。
1、在终端中执行以下命令：
starship preset nerd-font-symbols -o ~/.config/starship.toml
2、确认输出中包含"Preset applied successfully"提示信息。
3、重启当前终端或运行source $PROFILE（PowerShell）/ source ~/.zshrc（Zsh）/ source ~/.bashrc（Bash）重新加载配置。
二、手动导入预设配置文件
当starship preset命令不可用（如旧版本Starship）或需审查配置细节时，可下载并替换配置文件。此方法允许逐行校验符号定义、颜色映射与模块启用状态。
1、访问Starship官方预设仓库地址：https://github.com/starship/starship/tree/master/docs/public/presets
2、定位并下载nerd-font-symbols.toml文件。
3、将文件内容完整复制，粘贴覆盖至本地配置路径：~/.config/starship.toml
4、检查文件开头是否存在"$schema"声明及[preset]区块，确认name = "nerd-font-symbols"已启用。
三、验证Nerd Font字体安装与终端生效状态
预设启用后若图标仍异常，问题根源通常在于字体链未打通：系统已安装字体，但终端未正确调用或渲染引擎不支持。此步骤独立于Starship配置，属前置依赖验证。
1、在终端中运行：fc-list | grep -i "nerd"（Linux/macOS）或检查字体设置中是否列出FiraCode Nerd Font等字样（Windows）。
2、在终端设置中将默认字体明确指定为已安装的Nerd Font变体（如FiraCode Nerd Font Mono），禁用“使用系统字体”选项。
3、执行starship self-test命令，观察输出中"Nerd Font glyphs"检测项是否标记为✅ PASS。
四、回退至无图标兼容模式（应急方案）
当Nerd Font在特定终端（如Windows Console Host、某些远程SSH客户端）中持续失效，且无法更换终端时，可临时切换为纯文本符号预设，保留全部功能逻辑而规避渲染问题。
1、执行命令：starship preset no-nerd-font -o ~/.config/starship.toml
2、手动检查配置文件中[character]区块是否含success_symbol = "➜ "、error_symbol = "✗ "等ASCII替代符号。
3、对比Git模块中symbol = " "是否已被替换为symbol = "git:"等纯文本标识。
