一份配置通吃 10 种 Shell 的 Starship 提示符

知识点总结

换了 Shell,提示符配置又得重来一遍?

摘要

Starship 是 Rust 写的跨 Shell 提示符,一份 TOML 配置,bash、zsh、fish、PowerShell 等 10 种 Shell 都能用。本文带你装好、配好,再学会排查提示符变慢。

核心优势

Starship 2019 年 4 月开源,现在有 6 万多 Star、450 多位贡献者,最新版本是 1.27.0(2026-10-17)。它解决的是一个很具体的麻烦:提示符配置和 Shell 绑得太死。

  • 一份配置,处处通用:README 列出的支持范围包括 bash、zsh、fish、PowerShell、Nushell、Elvish、Ion、Tcsh、Xonsh,以及搭配 Clink 的 Cmd。Linux、macOS、Windows、BSD、Android(Termux)都有安装方式。
  • 核心是单个二进制:Rust 编写,提示符内容由它统一计算,各个 Shell 只负责调用。它的灵感来源之一 spaceship-prompt,在官方 README 里的定位是 ZSH 提示符,换 Shell 就得换一套方案。
  • 只显示当前用得上的信息:进了 Node.js 项目才显示 Node 版本,进了 Rust 项目才显示 Rust 版本,在 Git 仓库里才显示分支和状态。
  • 能管住自己的速度:默认只给文件扫描 30 毫秒(scan_timeout),外部命令 500 毫秒(command_timeout),超时就放弃,不会拖住你的回车。
  • 可配置到每个细节:每个模块的格式、符号、颜色都能改,还有 12 个官方预设可以直接套用。

面向人群

  • 同时用 zsh、fish、PowerShell,或者在 Mac、Linux 服务器、Windows 之间来回切换,想要统一的提示符;
  • 想在提示符里看到 Git 分支、语言版本、上条命令耗时,又不想折腾每个 Shell 各自的插件;
  • 嫌现有主题慢,想找一个能量化排查的方案。

快速上手

第 1 步:装字体

Starship 用到不少图标符号,需要在终端里启用一款 Nerd Font(官方示例是 FiraCode Nerd Font)。没装的话,图标可能显示成方块。

第 2 步:安装 Starship

# macOS / Linux 通用
curl -sS https://starship.rs/install.sh | sh

# macOS(Homebrew)
brew install starship

# Windows(winget)
winget install --id Starship.Starship

# 任意平台,从源码装
cargo install starship --locked

第 3 步:在 Shell 里初始化

把下面对应的一行加到配置文件末尾,然后新开一个终端:

# 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)

Nushell 要多一步:把下面两行加到 Nushell 配置文件末尾(在 Nushell 里运行 $nu.config-path 能查到路径),它会把初始化脚本写进自动加载目录(官方要求 Nushell 0.96 以上):

mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")

Cmd 需要先装 Clink(1.2.30 以上),再创建 %LocalAppData%\clink\starship.lua:

load(io.popen('starship init cmd'):read("*a"))()

做到这里,一个能用的提示符就有了,默认配置不用改。

进阶用法

一、写自己的配置

配置文件默认放在 ~/.config/starship.toml,也可以用环境变量 STARSHIP_CONFIG 指到别处。下面是一份常见的小改动:

# ~/.config/starship.toml

# 提示符之间不再空一行
add_newline = false

# 把命令成功/失败的箭头换掉
[character]
success_symbol = '[➜](bold green)'
error_symbol = '[✗](bold red)'

# 目录最多显示 2 层(默认是 3 层)
[directory]
truncation_length = 2

# 命令跑超过 500 毫秒就显示耗时(默认是 2000 毫秒)
[cmd_duration]
min_time = 500

# 不想看 package 版本,直接关掉
[package]
disabled = true

规则很简单:方括号标题是模块名,下面的键值是这个模块的选项。想关掉哪个模块,就在它下面写 disabled = true。

二、直接套预设

不想自己调颜色,可以用官方预设,目前有 Tokyo Night、Catppuccin Powerline、Gruvbox Rainbow、Pastel Powerline、Pure 等 12 个,还有不依赖 Nerd Font 的纯文本版本:

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

-o 指定输出文件,会写进你的配置文件,已有配置先备份再执行。

三、用 custom 模块加自己的信息

内置模块不够用时,可以让提示符显示任意命令的输出。下面这个例子在设置了代理环境变量时,提示符里多出一个「proxy」标记:

[custom.proxy]
command = 'echo proxy'
when = '[ -n "$HTTPS_PROXY" ]'
symbol = '🌐 '
style = 'bold yellow'

when 的命令返回 0 才会显示这个模块。它和 command 默认交给当前 Shell 执行,上面是 bash/zsh 的写法,PowerShell、Nushell 用户要换成自己 Shell 的语法,或者用 shell 选项指定解释器。也可以用 detect_files、detect_extensions 按当前目录里有没有某个文件来触发。注意:每次出提示符都会先跑一遍 when,条件满足再跑 command,所以两者都要足够快。

四、提示符变慢了怎么查

这是 Starship 最实用的一组排查命令:

# 看哪些模块耗时超过 1 毫秒,或者产生了输出
env STARSHIP_LOG=trace starship timings

# 提示符里有看不懂的符号,让它解释当前显示的每个模块
starship explain

# 只调试某一个模块的输出和日志
env STARSHIP_LOG=trace starship module rust

两个常见坑:

  • 出现「命令超时」警告:说明某个外部命令超过了 command_timeout(默认 500 毫秒),可以调大这个值,或者找出慢的命令优化。设置 STARSHIP_LOG=error 可以隐藏这类警告。
  • WSL 里进入 Windows 盘(如 /mnt/c)很慢:官方文档提示 git_status 模块在这类目录下会很慢,可以关掉该模块,或者用它的 windows_starship 选项改调 Windows 版可执行文件。

另外,1.27.0 包含两项安全修复,已经在用的话建议升级一下。

收藏清单

  1. 先装 Nerd Font,再装 Starship,最后在 Shell 配置末尾加一行 starship init。
  2. 配置都写在 ~/.config/starship.toml,用 disabled = true 关模块,用 starship preset 套预设。
  3. 提示符变慢先跑 env STARSHIP_LOG=trace starship timings,看不懂符号就跑 starship explain。

项目地址:github.com/starship/starship