Starship 安装指南：5 分钟在全平台装好你的跨 Shell 提示符

Starship 安装指南：5 分钟在全平台装好你的跨 Shell 提示符

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

Starship 是一个与 Shell 完全解耦的终端提示符二进制：Bash、Zsh、Fish、PowerShell 都能接入它。装好之后，Git 仓库里你会看到当前分支和改动状态，Python 目录下会亮起虚拟环境名，笔记本快没电时还会冒出电量图标——但整行提示符依然很短。整个过程拆成四步：装二进制、初始化 Shell、验证生效、按口味换皮，下面逐步走。

📦 一条命令装好二进制

这一步只负责把starship可执行文件放进 PATH，此时你的提示符还不会有任何变化。

Linux：按发行版挑一条

BSD 系统同样有官方包：FreeBSD 执行pkg install starship，NetBSD 执行pkgin install starship。

macOS：brew 一行搞定

brew install starship

习惯 MacPorts 的话改用：

sudo port install starship

🪟 Windows 安装 Starship：winget / choco / scoop 三选一

以管理员身份打开终端，任选一条执行：

winget install --id Starship.Starship

choco install starship

scoop install starship

兜底方案：官方一键脚本

发行版没收录、包管理器也懒得配？直接用官方脚本，它会自动识别你的系统架构并下载对应版本：

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

脚本不长，运行前可以打开 install/install.sh 先扫一眼。走源码路线的话需要本机装好 Rust 工具链，再执行cargo install starship --locked；Termux、Nix 这类小众平台的更细分做法在安装文档里。

⚡ 装完 ≠ 生效：给 Shell 加一行初始化

二进制躺在 PATH 里，提示符还不会变——你得让 Shell 知道"画提示符的事交给 starship"。做法是往你正在用的 Shell 的配置文件末尾追加一行：

Nushell、Tcsh、Elvish 等其他 Shell 的写法各不相同，全部生成脚本都放在初始化脚本目录，可以对照着抄。

保存配置后，执行source重载一下，或者直接重开一个终端窗口，新提示符就上线了。

✅ 30 秒确认它在工作

先做三个动作：重开终端看一眼提示符是否变了、跑一次starship --version确认命令在 PATH 中、Bash 用户再echo $PROMPT_COMMAND检查一下 starship 是否挂入了。都正常就收工；不正常的话，下面三个问题覆盖了九成翻车现场。

图标全是方框或?？

提示符里的箭头和 Git 图标来自 Nerd Font（一种内置了图标的等宽字体），没装或没选对字体就会显示成方块。装一个 FiraCode Nerd Font，在终端的字体设置里选它，重启终端即可。

starship --version有输出，提示符却纹丝不动？

初始化那一行没写进配置文件，或者写完没重载。对照上一节表格核对路径和内容，保存后重开终端；Bash 下用echo $PROMPT_COMMAND复核 starship 是否真的挂上了。

报~/.cache/starship权限错误？

缓存目录的属主和当前用户对不上，一行修复：

sudo chown -R $USER:$USER ~/.cache/starship

嫌麻烦就直接curl -sS https://starship.rs/install.sh | sh -s -- --force强制重装。timed out警告是什么意思、怎么用STARSHIP_LOG打开调试日志这类细节，FAQ 里都有。

🎨 换个味道：预设与进阶

装好之后，提示符的长相全靠~/.config/starship.toml这一个文件调。预设合集 里提供 tokyo-night、bracketed-segments、pastel-powerline、catppuccin-powerline 等开箱即用的主题，整段贴进配置就能换上：

再往深处走：所有模块的开关、格式串和超时参数都在配置文档；每个语言、VCS、云平台对应一个探测文件，源码按模块拆分在 src/modules/，想给 Starship 加功能可以从 CONTRIBUTING.md 入手。

下一步很简单：挑一个顺眼的预设贴进去，把用不到的模块关掉，你的提示符就成型了。

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