彻底卸载starship需四步:一、删除shell配置文件中starship init行并重载;二、移除~/.config/starship.toml;三、按安装方式卸载二进制(如brew uninstall starship);四、重置ps1/prompt变量并验证which starship为空、提示符恢复原生样式。

如果您已安装Starship并希望彻底卸载它,同时恢复系统原有的shell提示符(如Bash或Zsh默认的$或%),则需移除Starship初始化代码、配置文件及二进制程序。以下是多种可选的卸载与恢复方案:
一、移除Shell初始化代码
Starship通过在shell配置文件中插入初始化命令生效,卸载的第一步是定位并删除该行,以阻止其每次启动时加载。
1、打开对应shell的配置文件:Bash用户编辑~/.bashrc,Zsh用户编辑~/.zshrc,Fish用户编辑~/.config/fish/config.fish。
2、查找包含starship init的行,例如eval "$(starship init bash)"或starship init fish | source。
3、将该整行删除或用#注释掉。
4、保存文件后,执行source ~/.bashrc(或对应配置文件)使更改立即生效。
二、删除Starship配置文件
Starship的个性化行为由~/.config/starship.toml驱动,删除该文件可确保无残留配置干扰后续行为,同时为恢复默认提示符扫清障碍。
1、确认当前配置路径:运行echo $STARSHIP_CONFIG(Linux/macOS)或echo %STARSHIP_CONFIG%(Windows Cmd)。
2、若输出为空,则默认路径为~/.config/starship.toml;若非空,则使用该路径。
3、执行删除命令:rm -f ~/.config/starship.toml(Linux/macOS)或Remove-Item -Path $env:STARSHIP_CONFIG -Force(PowerShell)。
三、卸载Starship二进制程序
卸载核心程序可释放磁盘空间,并防止意外调用或版本冲突,不同安装方式对应不同卸载路径。
1、若通过curl脚本安装:执行rm -f /usr/local/bin/starship(Linux/macOS)或del %PROGRAMFILES%\Starship\starship.exe(Windows)。
2、若通过Homebrew安装:brew uninstall starship。
3、若通过Snap安装:sudo snap remove starship。
4、若通过Cargo安装:cargo uninstall starship。
四、强制重载原始shell提示符
即使卸载完成,部分shell可能仍缓存旧提示符逻辑,需显式重置PS1变量以确保回归原始状态。
1、对Bash用户:执行unset STARSHIP_CONFIG && PS1='\u@\h:\w\$ '(标准Bash默认格式)。
2、对Zsh用户:执行unset STARSHIP_CONFIG && PROMPT='%n@%m:%~%# '(Zsh默认格式)。
3、为永久生效,将上述PS1或PROMPT赋值语句追加至对应shell配置文件末尾(不带export)。
4、再次执行source命令刷新环境。
五、验证卸载完整性
执行终端命令检查是否已完全脱离Starship控制,避免残留模块或异常输出干扰日常操作。
1、输入which starship,若返回空行,表明二进制已不可见。
2、输入starship --version,应报错command not found。
3、新建终端窗口,观察提示符是否变为username@hostname:~/current/path$等原生样式,而非含图标或分段信息的Starship风格。
4、运行echo $PS1(Bash)或echo $PROMPT(Zsh),确认输出为原始字符串,不含$starship或$(starship prompt)等动态调用。











