Starship 是一款采用 Rust 编写的开源跨 Shell 提示符（Prompt），具有高渲染速度和高度可定制化的特点。

以下是 Mac 环境下的安装、配置及使用指南：

---

1. 安装步骤

基础安装

使用 Homebrew 安装 Starship 核心程序：

brew install starship

环境要求

• Nerd Font：Starship 大量使用图标，必须在终端（如 Ghostty 或 iTerm2）中设置支持图标的 Nerd Font（如 JetBrainsMono Nerd Font），否则会出现乱码。

---

2. 启用 Starship

要使 Starship 在终端启动时生效，需将其初始化脚本添加至 Shell 配置文件中：

针对 Zsh (Mac 默认)

编辑 ~/.zshrc：

echo 'eval "$(starship init zsh)"' >> ~/.zshrc
source ~/.zshrc

---

3. 配置文件管理

Starship 的所有设置均通过一个 TOML 文件完成：

• 文件路径：~/.config/starship.toml
• 创建命令：mkdir -p ~/.config && touch ~/.config/starship.toml

---

4. 核心配置模板

以下是一份兼顾效率与简洁的 starship.toml 配置示例：

# 在提示符之间不添加空行
add_newline = false

# 替换默认的字符（错误时显示红色）
[character]
success_symbol = "[❯](bold green)"
error_symbol = "[❯](bold red)"

# 目录配置
[directory]
truncation_length = 3        # 路径超过3层时进行缩减
truncate_to_repo = true      # 在 Git 仓库根目录停止缩减
style = "bold italic blue"

# Git 分支配置
[git_branch]
symbol = " "
style = "bold purple"

# Git 状态配置
[git_status]
format = '([\[$all_status$ahead_behind\]]($style) )'
style = "red"

# 命令执行耗时（超过 2 秒时显示）
[cmd_duration]
min_time = 2000
format = "took [$duration]($style) "

---

5. 预设主题 (Presets)

Starship 提供了多款官方预设配置，可以直接应用：

• 查看可用预设：访问 starship.rs/presets
• 应用预设命令（以 tokyo-night 为例）：

  starship preset tokyo-night -o ~/.config/starship.toml
  

---

6. 常用功能模块说明

Starship 会根据当前目录环境自动显示相关信息：

• 编程语言版本：进入含有 package.json 的目录会自动显示 Node.js 版本；进入含有 Cargo.toml 的目录会显示 Rust 版本。
• Git 状态：实时显示当前分支、是否有未提交修改、落后/超前远程分支的数量。
• 云服务状态：显示当前的 AWS 配置文件或 Kubernetes 上下文。

---

7. 性能监控

如果发现提示符加载缓慢，可执行以下命令排查耗时模块：

starship timings