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 | shWindows 用户也可以改用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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考