Starship 提示符 5 分钟上手：3 行配置改出你自己的终端提示符

Starship 提示符 5 分钟上手：3 行配置改出你自己的终端提示符

【免费下载链接】starship☄🌌️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship

Starship 是一个用 Rust 写的跨 Shell 提示符工具：装好后，它会在你的命令行提示符里显示当前路径、Git 分支和改动状态、编程语言版本、上一条命令的耗时等信息。它面向所有觉得默认 Shell 提示符"信息太少、长得还难看"的开发者，支持 Bash、Zsh、Fish、PowerShell 等主流 Shell，一次安装、所有 Shell 通用。

一条命令装好 Starship

Starship 本体是一个二进制文件，官方提供的安装脚本会自动把它装到系统里：

curl -sS https://starship.rs/install.sh | sh

Windows 用户也可以改用winget install --id Starship.Starship或choco install starship。

装完二进制只是第一步，还要告诉 Shell"用 Starship 来画提示符"。以 Bash 为例，把下面一行加到~/.bashrc末尾（Zsh 则加到~/.zshrc，把bash换成zsh即可）：

eval "$(starship init bash)"

这行命令的作用是：每次打开 Shell 时运行starship init，把生成提示符的脚本注入到当前 Shell 中。

打开终端，第一眼看到什么

重新打开一个终端（或执行source ~/.bashrc），提示符会变成这样的大致效果：

• ➜符号，上一条命令执行失败时变红；
• 当前目录，只保留最后几层，长路径自动截断；
• 在 Git 仓库里时，自动出现分支名和状态符号（有未提交改动显示✗、已暂存显示+）；
• 在项目目录下放了对应语言的标志文件（如package.json、pyproject.toml），会自动带上 Node.js 或 Python 的版本号。

下面这张图来自官方预设主题 Catppuccin Powerline 的实际效果，可以直观看到路径、Git 分支、语言版本各占一个色块：

改 3 行配置调整目录显示

Starship 的所有配置都集中在一个文件里：~/.config/starship.toml（Windows 是%USERPROFILE%\.config\starship.toml）。文件不存在就直接新建，保存后立刻生效，不用重启终端。

比如默认情况下目录只显示 3 层父目录，嫌太短就加一行；想改路径颜色，再加一行style：

[directory] truncation_length = 5 # 目录最多保留 5 层父目录 style = "bold blue" # 路径改成加粗蓝色

每个模块（[git_branch]、[nodejs]、[time]……）都是一个独立的配置段，互不影响，想改哪个就改哪个。完整选项可以在官方文档 docs/config/ 里查，每个模块都有对应的变量表和示例。

一行配置隐藏多余的模块

默认开启的模块里，有些你根本用不到。隐藏某个模块只需两行，把disabled = true放进对应段：

[battery] disabled = true

常见的"减负"操作：不写 Rust 就关掉[rust]，不用 Nix 就关掉[nix_shell]。模块越少，提示符越干净，渲染也越快。反过来，默认隐藏的模块（比如time显示当前时间）也支持用同样的方式加配置段来开启，缺省时就是默认值。

进阶玩法：套用预设主题和全局参数

一条命令套用预设主题

社区贡献了十几个现成主题（Tokyo Night、Jetpack、Pastel Powerline 等），内置命令可以一键写入配置文件，不用手抄：

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

注意-o会覆盖现有配置文件，自己调过的配置先备份。各主题的效果截图和说明见 docs/presets/。

两个值得调的全局参数

command_timeout = 300 # 单条探测命令的超时（毫秒），默认 500 add_newline = true # 每次提示符前是否空一行

网络环境较差或挂载了慢速目录时，把command_timeout调小能明显减少提示符的等待感；嫌提示符前那行空行占地方，就把add_newline改成false。

装好、调顺之后，提示符就是"打开终端就知道自己在哪、在哪个分支、改动有没有丢"的状态。剩下的模块和选项都可以等遇到具体需求再去 docs/config/ 里按模块查，不用一次看完。

【免费下载链接】starship☄🌌️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship