很多人把终端提示符（Prompt）折腾成“只在某个 shell/某个主题里好看”，一换环境就全乱。Starship 的思路更简单：用一个跨平台的提示符引擎，把样式和模块都写在同一份配置里，然后在 zsh/fish/bash 等不同 shell 里加载同一套效果。
适合的场景包括：你在 macOS 上同时用 iTerm2/系统终端、偶尔还要进 WSL/远程服务器；或你希望提示符在不同项目里展示 Git 状态、耗时、语言版本等信息，但又不想装一堆互相冲突的主题。
1）确认你的终端支持显示 Nerd Font 图标，否则很多主题会出现“方块/乱码”。
2）如果你用 Homebrew 管理软件，后续安装会更顺滑（没有也可以用官方安装脚本）。
在 macOS 上最省心的安装方式是 Homebrew：
brew install starship
安装完成后，你可以先验证一下是否可用：
starship --version
Starship 主题里经常会用到 Nerd Font 的图标字符。推荐从 Nerd Fonts 官方仓库选择一款（例如 JetBrainsMono Nerd Font、FiraCode Nerd Font），下载安装到系统后，在 iTerm2 或系统终端里切换字体。
参考链接（可直接打开）：https://www.nerdfonts.com/
iTerm2 字体设置路径一般是：Preferences → Profiles → Text → Font。系统终端则在：设置 → 配置文件 → 字体。
Starship 的配置文件默认位置是：
~/.config/starship.toml
你可以先放一个“够用、清爽、不花哨”的起步版，思路是：让提示符信息密度高但不吵（目录、Git、耗时、语言版本）。示例（可按需改）：
# ~/.config/starship.toml add_newline = false [character] success_symbol = "[➜](bold green)" error_symbol = "[➜](bold red)" [directory] truncation_length = 3 truncate_to_repo = true [git_branch] symbol = " " [git_status] disabled = false [cmd_duration] min_time = 500 format = "took [$duration]($style) " [nodejs] format = "via [node $version]($style) " [python] format = "via [py $version]($style) "
如果你发现某些模块让提示符变慢（例如大型仓库下 Git 状态计算），可以先关闭对应模块，再逐个打开排查。
关键点：不同 shell 的启动脚本不同，但加载 Starship 的方式很统一。
zsh（~/.zshrc）追加：
eval "$(starship init zsh)"
fish（~/.config/fish/config.fish）追加：
starship init fish | source
bash（~/.bashrc 或 ~/.bash_profile）追加：
eval "$(starship init bash)"
完成后新开一个终端窗口，应该就能看到生效的提示符了。
1）图标显示成方块/问号：基本是字体没换到 Nerd Font，或者终端渲染没有用到你安装的字体。先在终端里确认字体设置，再重启终端。
2）提示符卡顿：优先检查是否在超大 Git 仓库里开启了 git_status 等模块；也可以把 cmd_duration 的阈值调高减少噪音。Starship 官方也提供了性能建议。
3）远程 SSH 里显示异常：远程环境的字体由本地终端决定，但如果远程 shell 不同（比如默认是 bash），记得在对应的启动文件里也加上 init。
Starship 官方主页：https://starship.rs/
Nerd Fonts：https://www.nerdfonts.com/
iTerm2：https://iterm2.com/
