需重新安装覆盖二进制并手动适配配置:linux/macos用curl安装,windows用winget,rust用户可cargo install;支持self-update的版本可直接运行starship self-update;配置文件须将prompt_order等替换为format语法;最后重载shell并验证版本。

如果您当前使用的是旧版本Starship,希望将其升级至最新稳定版,则需根据操作系统类型执行对应安装命令,并同步处理配置文件兼容性问题。以下是完成升级的步骤:
一、执行系统适配的最新版安装命令
Starship不提供传统意义上的“增量升级”机制,而是通过重新安装覆盖方式更新二进制文件。该操作会保留原有配置文件,但需手动适配新版格式要求。
1、Linux或macOS用户在终端中运行以下命令:
curl -sS https://starship.rs/install.sh | sh
2、Windows用户在PowerShell(以管理员身份运行)中执行:
winget install starship
3、若已安装Starship且使用Rust工具链,可改用Cargo安装:
cargo install --force starship
二、执行自更新命令(仅限部分版本支持)
部分v1.0+版本内置self-update功能,可在不重装前提下拉取最新预编译二进制。该方式依赖官方CDN可用性及本地权限配置。
1、在任意shell中输入以下命令:
starship self-update
2、如提示“command not found”,说明当前版本低于v1.1.0,需退回第一种安装方式。
3、执行后等待输出“Successfully updated starship”即表示完成。
三、迁移旧版配置文件以适配新格式
v0.45.0起Starship引入重大配置结构变更,原prompt_order、prefix/suffix等字段被统一替换为format语法。若跳过此步,提示符将无法正常渲染模块。
1、打开配置文件:~/.config/starship.toml
2、将原prompt_order数组整体删除,替换为根级format字段,例如:
format = """\n$username\n$hostname\n$directory\n$git_branch\n$character\n"""
3、逐个检查模块段落,将prefix/suffix改为format,如[cmd_duration]段应由:
[cmd_duration]\nprefix = "took "
改为:
[cmd_duration]\nformat = "took $duration "
四、重新加载Shell环境并验证
安装与配置更新后,必须重新加载Shell初始化脚本,使starship init注入的新提示符生效,同时确认版本号是否匹配预期。
1、根据所用Shell执行对应重载命令:
source ~/.bashrc(Bash用户)
source ~/.zshrc(Zsh用户)
2、运行版本检测命令:
starship --version
3、观察终端首行是否显示形如starship 1.23.0的输出结果。











