若starship图标显示为方块、问号或乱码，需安装并配置nerd font：一、下载安装firacode或jetbrainsmono等nerd font；二、在终端设置中指定该字体并启用ascii字符渲染；三、运行starship self-test确认检测结果为true；四、如需回退可修改starship.toml改用ascii符号；五、执行starship preset nerd-font一键启用完整图标支持。
如果您已安装Starship但终端中图标显示为方块、问号或乱码，则极大概率是终端未正确加载或配置Nerd Font。以下是实现Nerd Font图标正常显示的多种方法：
一、确认并安装兼容的Nerd Font
Nerd Font是包含大量扩展图标的补丁字体，Starship依赖其字形渲染分支符号、语言标识、状态图标等。未安装任何Nerd Font时，所有symbol字段将无法正确呈现。
1、访问Nerd Fonts官网，下载推荐字体包，如FiraCode Nerd Font或JetBrainsMono Nerd Font；
2、解压压缩包，获取.ttf或.otf字体文件；
3、将全部字体文件复制到系统字体目录：
Linux：放入~/.local/share/fonts/或/usr/share/fonts/；
macOS：双击字体文件并点击“安装字体”，或复制到~/Library/Fonts/；
Windows：右键字体文件选择“为所有用户安装”；
4、刷新字体缓存：
Linux/macOS执行fc-cache -fv；
Windows无需手动刷新。
二、在终端模拟器中启用Nerd Font
仅安装字体不等于终端能调用——必须在终端应用设置中显式指定所用字体。若终端仍使用默认字体（如Monaco、Consolas、DejaVu Sans Mono），图标将保持乱码。
1、打开终端模拟器设置界面（如iTerm2偏好设置→Profiles→Text，或GNOME Terminal→Preferences→Profile→Text，或Windows Terminal→Settings→Profiles→Defaults→Appearance）；
2、在字体（Font）或文字（Text）设置项中，找到“字体族”（Font Family）下拉菜单；
3、从中选择已安装的Nerd Font变体，例如FiraCode Nerd Font Mono或JetBrainsMono Nerd Font；
4、确保勾选“使用此字体绘制ASCII字符”或“Use this font for ASCII characters”（部分终端需显式启用）；
5、保存设置并重启终端窗口（非仅新建标签页）。
三、验证Nerd Font是否被Starship识别
Starship提供内置检测机制，可判断当前环境是否具备Nerd Font支持能力，并提示缺失组件。该步骤可排除字体已安装但未被正确识别的情况。
1、在终端中运行命令：starship self-test；
2、观察输出中的Font Check部分；
3、若显示"Nerd Font detected: true"，说明字体已就绪；
4、若显示"Nerd Font detected: false"，则需返回前两步检查字体安装路径与终端字体设置是否匹配；
5、注意：该检测不校验具体图标是否渲染成功，仅确认字体存在且可被Rust字体探测模块读取。
四、强制禁用Nerd Font图标回退方案
当Nerd Font不可用或导致显示异常（如宽字符错位、光标偏移）时，可通过配置跳过图标依赖，改用纯ASCII符号，保障基础功能可用性。
1、编辑Starship配置文件：~/.config/starship.toml；
2、在文件顶部添加预设启用指令：
[preset]<br>disabled = false<br>name = "no-nerd-font"；
3、或逐模块覆盖symbol字段，例如：
[git_branch]<br>symbol = "branch "（使用空格+英文单词替代
）；4、保存后执行starship explain确认当前生效配置中symbol值已变更；
5、该方式下所有图标均替换为无特殊字形依赖的ASCII字符，适用于无障碍场景或老旧终端。
五、通过Starship官方预设一键启用Nerd Font支持
Starship内置多套经过验证的Nerd Font适配预设，可绕过手动配置symbol字段的繁琐过程，直接激活完整图标集。
1、运行初始化命令：starship preset nerd-font；
2、该命令将自动写入适配Nerd Font的模块配置至~/.config/starship.toml；
3、关键改动包括：
启用[aws]模块的符号、[docker_context]的、[git_commit]的✦等；
4、检查配置文件末尾是否新增了类似# Generated by starship preset nerd-font的注释区块；
5、重启终端后，所有模块将按预设使用Nerd Font专属Unicode码位渲染图标。
