starship

starship — 极简、超快的跨平台 Shell 提示符美化工具，让终端告别杂乱。

最近折腾终端，发现一个宝藏工具——starship。说实话，我本来对 Shell 美化这件事挺不屑的，觉得花里胡哨的提示符除了好看没啥用。直到某天在多个项目间切换时，被 node_modules 路径和 git 分支搞得头昏脑涨，才意识到一个清晰的信息提示能省多少时间。

starship 就是干这个的：它用 Rust 写的，启动速度毫秒级，能自动显示当前目录、Git 状态、Node.js/Python/Rust 等运行环境版本、命令执行时间、错误码…… 而且跨平台（Linux/macOS/Windows 全支持），配置起来像写 JSON 一样简单。最关键的是——它默认主题就很好看，不用你折腾配色。

下载方式

直接去 官网 下载，或者用包管理器安装。官网有各种系统的一键脚本，非常友好。

安装方法

MacOS / Linux 用户：用 Homebrew 或 curl 都行。

# Homebrew（推荐）
brew install starship

# 或者用官方脚本
curl -sS https://starship.rs/install.sh | sh

Windows 用户：用 Scoop 或 Chocolatey。

# Scoop
scoop install starship

# Chocolatey
choco install starship

安装完别急，还要在 Shell 配置文件里加一行。以最常见的 bash/zsh 为例：

bash：编辑 ~/.bashrc，在末尾加上：

eval "$(starship init bash)"

zsh：编辑 ~/.zshrc，在末尾加上：

eval "$(starship init zsh)"

fish：编辑 ~/.config/fish/config.fish，加上：

starship init fish | source

PowerShell：编辑 $PROFILE，加上：

Invoke-Expression (&starship init powershell)

重新打开终端，你就会看到一个干净漂亮的提示符——默认主题是深色背景配白色文字，Git 分支、版本号、错误码都自动显示在右侧，像这样：

~/projects/my-app (main) ❯

基础使用教程

默认配置已经够用，但 starship 真正强大的是可定制性。配置文件在 ~/.config/starship.toml，如果没有就手动创建。

1. 关闭不需要的模块
比如我不用 Python，就把它关掉：

[python]
disabled = true

2. 缩短路径显示
默认显示完整路径，太长。改成只显示最后两级目录：

[directory]
truncation_length = 2

3. 显示命令执行时间
超过 2 秒的命令自动显示耗时，方便排查卡顿：

[cmd_duration]
min_time = 2000
show_milliseconds = true

4. 自定义 Git 状态
显示当前分支、修改文件数、未提交变更：

[git_branch]
format = "on [$branch]($style) "
[git_status]
conflicted = "🏳"
ahead = "⇡${count}"
behind = "⇣${count}"

5. 显示 Node.js 版本
自动检测项目中的 .nvmrc 或 package.json：

[nodejs]
format = "via [⬢ $version]($style) "

改完配置后，重新打开终端或执行 exec $SHELL 就能看到效果。

进阶技巧

1. 主题预设
官方提供了几十套主题，比如我用的 pastel-powerline：

starship preset pastel-powerline -o ~/.config/starship.toml

然后手动调整颜色。或者去 starship 主题仓库 找灵感。

2. 自定义符号
starship 默认用一些 emoji 和 Unicode 符号，你可以换成自己喜欢的。比如把 Python 符号改成 🐍：

[python]
symbol = "🐍"
format = "via [${symbol}${version}]($style) "

3. 环境变量模块
显示自定义环境变量，比如 KUBECONFIG 或 AWS_PROFILE：

[custom.kube]
command = "echo $KUBECONFIG"
when = """test -n "$KUBECONFIG" """
style = "bold blue"
format = "k8s: [($output)]($style) "

4. 多行提示符
如果信息太多，可以分成两行。第一行显示路径和版本，第二行只显示输入光标：

[character]
success_symbol = "[▶](bold green)"
error_symbol = "[▶](bold red)"

然后在 ~/.config/starship.toml 里加上：

format = """
$directory\
$git_branch\
$git_status\
$nodejs\
$python\
$rust\
$cmd_duration\
$line_break\
$character"""

5. 性能优化
starship 本身很快，但如果你装了太多模块（比如 kubernetes、docker 之类的），每次提示符都会执行外部命令。可以设置超时时间：

[kubernetes]
disabled = false
timeout = 500  # 毫秒，超过500ms就跳过

或者干脆关掉不常用的模块。

6. 与 tmux 集成
如果你用 tmux，可以在 status bar 里显示 starship 的某些信息。不过更简单的做法是直接用 starship 的 $PROMPT 变量。

最后说两句

starship 是我用过的 Shell 美化工具里最省心的一个——不依赖字体、不拖慢启动速度、配置直观。以前用 oh-my-zsh 时，每次打开终端都要等一秒加载主题，现在 starship 几乎感觉不到延迟。

如果你还在用默认的 user@host ~ $ 这种万年不变的提示符，强烈建议试试。花十分钟配置，以后每天看终端的心情都会好很多。

对了，如果遇到问题，直接看 官方文档，写得非常详细。或者去 GitHub 提 issue，社区很活跃。

现在就去装一个吧，保证真香。