Starship 是一款采用 Rust 编写的开源跨 Shell 提示符(Prompt),具有高渲染速度和高度可定制化的特点。
以下是 Mac 环境下的安装、配置及使用指南:
1. 安装步骤
基础安装
使用 Homebrew 安装 Starship 核心程序:
bash
brew install starship
环境要求
- Nerd Font :Starship 大量使用图标,必须在终端(如 Ghostty 或 iTerm2)中设置支持图标的 Nerd Font(如
JetBrainsMono Nerd Font),否则会出现乱码。
2. 启用 Starship
要使 Starship 在终端启动时生效,需将其初始化脚本添加至 Shell 配置文件中:
针对 Zsh (Mac 默认)
编辑 ~/.zshrc:
bash
echo 'eval "$(starship init zsh)"' >> ~/.zshrc
source ~/.zshrc
3. 配置文件管理
Starship 的所有设置均通过一个 TOML 文件完成:
- 文件路径 :
~/.config/starship.toml - 创建命令 :
mkdir -p ~/.config && touch ~/.config/starship.toml
4. 核心配置模板
以下是一份兼顾效率与简洁的 starship.toml 配置示例:
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为例):bashstarship preset tokyo-night -o ~/.config/starship.toml
6. 常用功能模块说明
Starship 会根据当前目录环境自动显示相关信息:
- 编程语言版本 :进入含有
package.json的目录会自动显示 Node.js 版本;进入含有Cargo.toml的目录会显示 Rust 版本。 - Git 状态:实时显示当前分支、是否有未提交修改、落后/超前远程分支的数量。
- 云服务状态:显示当前的 AWS 配置文件或 Kubernetes 上下文。
7. 性能监控
如果发现提示符加载缓慢,可执行以下命令排查耗时模块:
bash
starship timings