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 终端提示符。Starship 安装只做两件事：把二进制装进系统，再往 Shell 配置里加一行初始化语句，覆盖 Linux、macOS、Windows 与 BSD 的官方途径。

先跑起来：各系统默认安装命令

这一节直接用系统包管理器把二进制装好，装完进入第二节配 Shell 即可。动手前注意两点：提示符图标依赖 Nerd Font（建议先装好 FiraCode Nerd Font 并在终端里选为默认字体）；包管理器途径大多需要 sudo（Windows 建议用管理员终端），且本节的途径都需要联网。

系统	推荐途径	安装命令
Arch Linux	pacman	`sudo pacman -S starship`
Debian / Ubuntu	apt	`sudo apt install starship`
Fedora	dnf（copr 源）	`sudo dnf copr enable atim/starship && sudo dnf install starship`
openSUSE	zypper	`sudo zypper in starship`
Alpine Linux	apk	`sudo apk add starship`
macOS	Homebrew	`brew install starship`
Windows 11+	Winget	`winget install --id Starship.Starship`
FreeBSD	pkg	`pkg install starship`
NetBSD	pkgin	`pkgin install starship`

按你的发行版取对应那一行执行就行，不需要逐系统单独查资料。

⚡ 默认方式不适用时：一键脚本与源码编译兜底

上面装不上，或你的环境没被收录，按"场景 → 命令"挑一条：

包管理器没收录 Starship（常见于小众 Linux 发行版、其他 BSD）：走官方一键脚本，它会自动检测系统架构并下载对应版本。脚本源码在 install/install.sh，可以先看一眼再执行：
```
curl -sS https://starship.rs/install.sh | sh
```
想从源码编译（也是没有现成包时的最后退路）：cargo install starship --locked。前提是本机有 Rust 开发环境，没有就先装好 Rust 工具链再执行。
macOS 习惯用 MacPorts：sudo port install starship，与 Homebrew 二选一即可。
Windows 想用图形化安装包：从项目发布页下载 MSI 安装包手动安装。
Windows 已装 Chocolatey 或 Scoop：choco install starship或scoop install starship。

让 Shell 认出新提示符：初始化语句一览表与验证

二进制装好后，Shell 不会自动使用它，还要在配置里加一行初始化语句，告诉 Shell 用 Starship 生成提示符：

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、Cmd、Tcsh、Elvish 等其余 Shell 的初始化语句各不相同，脚本都在 src/init/ 目录，如 starship.bash、starship.zsh、starship.fish。

装完后按下面 4 步确认是否生效：

重开一个终端窗口，或执行source重载配置文件；
提示符应已变成 Starship 的样式；
Bash 下运行echo $PROMPT_COMMAND，输出中应包含 starship 相关内容；
运行starship --version，确认可执行文件在 PATH 中。

🩹 出问题时这样自查：3 个高频问题诊断

装完不对劲，多半是这三种情况之一，逐条对照：

如果你看到提示符里的箭头、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。

更边缘的情况（旧版 glibc 系统用 musl 二进制、timed out警告的含义、用STARSHIP_LOG开调试日志）见 docs/faq/README.md。

接下来去哪

到这里提示符已经在正常干活了，剩下的就是挑个顺眼的预设、关掉不用的模块。

完整配置：docs/config/README.md 覆盖所有模块的开关、格式与超时参数，配置文件为~/.config/starship.toml。
预设主题：docs/presets/README.md 有 bracketed-segments、tokyo-night、pastel-powerline 等开箱即用主题，效果参考：
多语言文档：docs/zh-CN/guide/README.md 是简体中文指南，日文、西班牙文等其余语种在docs/目录下。
模块源码：每种语言、VCS、云平台的探测逻辑对应一个文件，集中在 src/modules/。
参与开发：CONTRIBUTING.md 说明开发流程，想读全部源码可执行git clone https://gitcode.com/GitHub_Trending/st/starship，问题反馈走项目 Issue 区。