Starship 快速指南5 分钟装好一个自动显示项目信息的 Shell 提示符【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship刚做完 A 项目切到 B 项目终端提示符还停在旧路径上。分支名、有没有未提交的改动、现在用的是哪个 Node 版本你得来回敲 git status 和 node -v 确认。Starship 就是一个用 Rust 写的 shell 提示符它自动识别当前项目把分支、Git 状态、语言版本直接拼进提示符里。多项目切换不用再手动确认。一句话看懂这个 shell 提示符解决什么问题一句话说清Starship 用按模块自动探测的提示符替换你 shell 的默认提示符当前目录里有什么它就在光标下那一行显示什么没有就隐藏。项目内容实现语言Rust单一二进制当前版本 1.26.0支持的 shellBash、Zsh、Fish、PowerShell、Elvish 等支持平台Windows、macOS、主流 Linux 发行版核心机制30 多个模块按当前目录内容自动开关默认超时500ms跑太慢的模块直接跳过适合谁多项目切换、不想再手敲 git status 的人五分钟跑通安装并接入你的 shell第 1 步安装二进制。macOS 和 Linux 用 brew 最直接装了 Rust 也可以用 cargo 直接从源码构建brew install starship # 或cargo install starship echo eval $(starship init zsh) ~/.zshrc source ~/.zshrc装完这步你应该看到starship --version打印出 1.26.0新开一个终端窗口提示符已经变成带颜色的模块样式——用户名、目录、Git 分支各占一段。第二行是把初始化代码写进 Zsh 配置用 Bash 就把 zsh 改成 bash。第 2 步可选生成配置文件。建议先生成一份默认配置再动手改避免从零写起在终端执行starship preset default -o ~/.config/starship.toml。跑完你会得到一个完整的 ~/.config/starship.toml提示符外观不变但从此可以逐模块修改。核心能力实战三个真实场景前端场景Node 项目路径和版本自动就位你在一个 monorepo 里干活路径深达五六层提示符被整条长路径占满Node 版本又完全看不到。Starship 的 directory 模块负责截断路径nodejs 模块检测到 package.json 才显示版本。改一处配置即可[directory] truncation_length 2 [nodejs] format via $symbol$version 改完打开前端项目你会看到类似~/apps/admin 22.11.0的提示符路径只剩两段版本号跟在后面退出这个目录版本模块自动消失。数据场景Python 项目虚拟环境自动识别你的分析脚本散在几个目录里每个目录各有一个 venv。最常见的烦恼是刚激活的环境自己都不确定对不对。python 模块会在检测到 venv 时显示 Python 版本不在 Python 目录时整个模块隐藏。你不需要任何配置cd 进带 venv 的目录提示符末尾就会多出py 3.12.4离开后立刻收回。运维场景Git 状态一眼判断能不能推长驻仓库发布前改配置你最关心的是干不干净、落后远程几个提交。git_branch 和 git_status 模块把状态渲染成符号*1是已修改未暂存~2是已暂存↑1表示领先远程 1 个提交。默认符号偏少想控制显示内容可以这样写[git_status] format $all_status$ahead_behind 跑一条 git push 之后刷新提示符↑1会变成空ahead/behind 信息一眼可读配合 cmd_duration 模块慢命令还会在提示符上留下耗时记录。避坑清单4 个高频问题及处理符号显示成问号或方框→ 终端没装 Nerd Font → 换一款 Nerd Font或直接使用项目自带的 no-nerd-font 预设。改了配置没生效→ 文件路径不对或 TOML 语法错误 → 确认编辑的是 ~/.config/starship.toml终端里跑starship explain查看每段提示符的实际来源。新开 shell 提示符变回老样子→ 这个 shell 没执行 init → 每个 shellzsh、bash、powershell都要各写一行starship init shell。打开终端卡一下→ 某个自定义模块在跑慢命令 → 默认超时 500ms 会跳过它删掉该模块或为它单独放宽超时即可。延伸与下一步官方文档入口docs/README.md全部预设主题13 个含无字体符号版docs/presets/README.md核心源码所有模块实现都在这个目录src/modules/需要源码构建时clone 地址https://gitcode.com/GitHub_Trending/st/starship 下一个值得尝试的能力是 custom 自定义模块任意一条 shell 命令的输出比如当前 Docker 容器名、K8s 命名空间都能塞进提示符实现见 src/modules/custom.rs。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考