快速定位

一句话架构

• Starship 的本质不是“主题包”，而是一个按模块拼装的提示符渲染器。
• 你要控制的核心只有三层：全局格式、模块显示规则、模块样式。
• 最常见的提效方式不是堆模块，而是把没用的模块关掉，把高频模块放到最顺手的位置。

最短上手流

# 1) 安装
curl -sS https://starship.rs/install.sh | sh

# 2) 任选 shell 初始化（以 bash 为例）
echo 'eval "$(starship init bash)"' >> ~/.bashrc
source ~/.bashrc

# 3) 创建配置
mkdir -p ~/.config && touch ~/.config/starship.toml

最小可用配置

# ~/.config/starship.toml
"$schema" = 'https://starship.rs/config-schema.json'
add_newline = false
scan_timeout = 20
command_timeout = 800
format = '$directory$git_branch$git_status$line_break$character'
right_format = '$time'

[character]
success_symbol = '[➜](bold green)'
error_symbol = '[➜](bold red)'
vimcmd_symbol = '[❮](bold purple)'

[directory]
truncation_length = 3
truncate_to_repo = true

配置文件基础

路径与切换

• ~/.config/starship.toml
• STARSHIP_CONFIG=/path/to/starship.toml
• 改完配置后，通常需要重新加载 shell 或直接新开一个终端窗口

最常调的全局项

format 的理解

• format
• $all
• line_break

format = '$all$line_break$character'
# 或者更克制一点
format = '$directory$git_branch$git_status$line_break$character'

高频模块速查

1. character：最后那个提示符

[character]
success_symbol = '[➜](bold green)'
error_symbol = '[✗](bold red)'
vimcmd_symbol = '[❮](bold purple)'

• 这是你最容易感知到的“最后一笔”。
• 颜色最好能一眼区分成功 / 失败 / vim 模式。

2. directory：当前目录

[directory]
truncation_length = 3
truncate_to_repo = true
style = 'bold cyan'
read_only = ' 🔒'

• 常用来控制路径长度，避免 prompt 太长。
• truncate_to_repo = true

3. git_branch / git_status：仓库状态

[git_branch]
symbol = ' '
format = '[$symbol$branch]($style) '
style = 'bold purple'

[git_status]
format = '([$all_status$ahead_behind]($style) )'
style = 'bold yellow'

• git_branch
• git_status
• 仓库工作流里，这两个通常是最值得保留的模块。

4. cmd_duration：慢命令耗时

[cmd_duration]
min_time = 2_000
show_milliseconds = false
format = 'took [$duration]($style) '
style = 'bold yellow'

• 适合在你只关心“这个命令有没有拖慢”时打开。
• 太短的命令不必刷屏。

5. package / nodejs / python / rust：语言与项目识别

[package]
disabled = true

[nodejs]
format = 'via [Node.js $version](bold green) '

[python]
format = 'via [Python $version( \($virtualenv\))](yellow bold) '
pyenv_version_name = true

[rust]
format = 'via [Rust $version](bold red) '

• package
• python rust nodejs
• Python 虚拟环境激活时，Starship 能把虚拟环境名一起带出来。

6. hostname / username / shell：远程与环境提示

[hostname]
ssh_only = true
format = '[$hostname](bold green) '

[username]
disabled = false
show_always = false

[shell]
disabled = false
format = '[$indicator]($style) '

• hostname
• shell

7. time / status / jobs：右侧信息更适合放这里

[time]
disabled = false
format = '[$time]($style) '
style = 'dimmed white'

[status]
disabled = false
format = '[$symbol$status]($style) '

[jobs]
number_threshold = 1
symbol_threshold = 1

• time right_format
• status
• jobs

常用 prompt 模板

模板 A：最清爽的开发 prompt

add_newline = false
format = '$directory$git_branch$git_status$line_break$character'

[package]
disabled = true
[python]
disabled = true
[rust]
disabled = true
[nodejs]
disabled = true

模板 B：项目型工作台

format = '$directory$git_branch$git_status$line_break$cmd_duration$character'
right_format = '$time'

[cmd_duration]
min_time = 1_500

模板 C：SSH / 运维场景

format = '$username$hostname$directory$git_branch$line_break$character'

[hostname]
ssh_only = true

[time]
disabled = false

高级一点但仍常用的调整

让 prompt 更短

• directory.truncation_length
• 关闭不常看的语言模块
• right_format
• line_break

让 prompt 更稳

• 确认终端里装了 Nerd Font，否则图标可能变方块
• scan_timeout
• command_timeout
• follow_symlinks = false

让 prompt 更像“工作台”而不是“装饰品”

• directory git_branch git_status character：、、、
• cmd_duration time status：、、
• package shell hostname：、、（除非你真会看）

常见坑

速记版

• 先接 shell init，再改 starship.toml
• 最常保留：directory + git_branch + git_status + character
• 最常放右侧：time + status + cmd_duration
• 最常关闭：package
• 想短就裁目录，想稳就调超时，想美就先换 Nerd Font