Starship 安装指南：3 步装好你的跨 Shell 终端提示符
【免费下载链接】starship☄🌌️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship
Starship 是一个跨 Shell 的终端提示符：在 Git 仓库里显示分支和改动状态，在项目目录显示 Python、Node 等运行时版本，还能带电量、命令耗时等信息，同时保持提示符简短、切换快。本文带你走 3 步把它装好：装二进制、接上 Shell、验证生效，最后给常见故障的排查方法。
第 1 步 ⚡：从下面表格里挑一条命令，装好 Starship
这一步没有技巧：对着你的系统找到那行，复制命令执行就行。动手前先注意三件事：提示符的图标依赖 Nerd Font，建议提前装好 FiraCode Nerd Font 这类字体；包管理器方式大多需要 sudo 或管理员终端；除源码编译外，其余方式都要联网下载。
| 系统 | 官方方式 | 安装命令 |
|---|---|---|
| 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 | apk | sudo apk add starship |
| macOS | Homebrew | brew install starship |
| macOS | MacPorts | sudo port install starship |
| Windows | Winget | winget install --id Starship.Starship |
| Windows | Chocolatey / Scoop | choco install starship或scoop install starship |
| FreeBSD | pkg | pkg install starship |
| NetBSD | pkgin | pkgin install starship |
| 任意平台 | 官方一键脚本 | curl -sS https://starship.rs/install.sh \| sh |
| 任意平台 | 源码编译 | cargo install starship --locked |
补充几句：一键脚本会自动识别系统和架构，下载匹配的二进制，是发行版没收录 Starship 时的兜底方案，脚本源码在 install/install.sh，不放心可以先看一眼再执行。源码编译要求本机先装好 Rust 工具链，cargo install会从头编译，耗时较长。不想用包管理器的 Windows 用户，可以直接从项目的 Releases 下载 MSI 安装包手动装。Termux、Nix 等小众平台的装法，官方安装文档 里都有覆盖。
第 2 步 🔌：往 Shell 配置文件写一行初始化语句
这一步才是让提示符真正换掉的关键：Shell 不会自动接上 Starship，得你手动告诉它。打开下面对应 Shell 的配置文件，在末尾加一行，保存。
| 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、Elvish、Tcsh 这类其他 Shell 的话，初始化语句略有差异，每个 Shell 对应的脚本都放在项目的 初始化脚本目录 里，按名字找就行。注意别写错文件：平时用 Zsh 却把语句加进了 ~/.bashrc，就会出现"装好了但没变化"的情况。
第 3 步 ✅：重载终端，验证提示符已切换
重开一个终端窗口，或者在旧窗口里 source 一下刚改的配置文件，提示符应该立刻变成 Starship 的样式；如果还是老样子，直接跳下一节排查。想确认得彻底，再跑两条命令做个完整检查：第一条确认二进制在 PATH 里，第二条确认 starship 已挂入 Bash 的提示链。
starship --versionecho $PROMPT_COMMAND一切正常的话，终端会随目录和上下文切换实时刷新信息，装好后的效果看下面这个演示：
演示里能看到 Git 分支、Git 状态、语言运行时版本和命令耗时随操作实时变化，切进 Git 仓库、Python 虚拟环境时对应模块会自动出现。
图标方框、提示符没变化、权限报错：三种故障的排查
装完后出问题基本集中在这三处，对症处理，一两分钟能解决。
图标显示成方框或问号
这是字体问题，不是安装失败：提示符的图标依赖 Nerd Font。装一个 FiraCode Nerd Font，在终端的字体设置里选它，重启终端就正常了。
这是图标正常时的效果，对照一下你的终端是不是缺了这些符号。
提示符完全没有任何变化
先跑starship --version确认二进制能执行。能执行的话回头核对两件事：初始化语句是否真的写进了配置文件；写的是不是当前 Shell 对应的那个文件，比如平时用 Zsh 却写进了 ~/.bashrc。Windows 和 WSL 环境的话，再确认你实际在用的 shell 是不是被改的那个。都对就重开终端，Bash 下再用echo $PROMPT_COMMAND看输出里有没有 starship。
提示缓存目录没有读写权限
一般是~/.cache/starship的属主和当前用户不一致，把属主改回当前用户即可：
sudo chown -R $USER:$USER ~/.cache/starship改不了的话，让官方脚本加--force参数强制重装一次也行。像 timed out 警告的含义、用STARSHIP_LOG环境变量开调试日志这类更细的问题，都写在 FAQ 文档 里。
装完之后的进阶玩法：换主题、关模块、读源码
Starship 的可玩性全在配置文件~/.config/starship.toml里，装完后值得花时间调三样东西。
换主题：项目内置了 bracketed-segments、tokyo-night、pastel-powerline 等预设，把预设配置贴进配置文件就能生效，全部预设见 预设合集。
这是 tokyo-night 预设的效果：深色底配彩色分段，模块之间用箭头衔接，整体观感很干净。
关模块：每个模块都能单独开关、改格式、调超时，不想显示语言版本就把它关掉；还可以用 custom 模块跑任意自己的命令。完整参数见 配置文档。
读源码：每个提示符模块对应 src/modules/ 下的一个文件，Git、云账号、语言探测的逻辑分得很开。想参与开发，先git clone https://gitcode.com/GitHub_Trending/st/starship拉下仓库，流程按 CONTRIBUTING.md 走。文档还有日文、西班牙文等多语言版本，简体中文指南可以直接看。
三步走完，Starship 就在你的终端里常驻了；后面想怎么调样式、关哪个模块，照着文档慢慢玩就行。
【免费下载链接】starship☄🌌️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
