网站 · 安装 · 配置

Starship 可以适配于任何 shell，是一种轻量，快速，高度可定制化的提示符工具！
它在可以你工作时展示你所需要的信息，兼备的流畅的使用体验。

使用 iTerm 和 Snazz 主题的 Starship

## 🍬 特性 - 当上一个命令以非 0 状态退出时，提示字符会变为红色 - 显示当前 Go 版本（`🐹`） - 显示当前 Haskell 版本（`λ`） - 显示当前 Java 版本（`☕`） - 显示当前 Node.js 版本（`⬢`） - 显示当前 PHP 版本（`🐘`） - 显示当前 Python 版本（`🐍`） - 显示当前 Ruby 版本（`💎`） - 显示当前 Rust 版本（`🦀`） - 显示当前 .NET 版本（`•NET`） - 显示当前目录中项目的版本（`📦`） - npm (Node.js) - cargo (Rust) - poetry (Python) - composer（PHP） - 显示当前的 Git 分支与各种仓库状态： - `=` —— 修改冲突 - `⇡` —— 领先于远程分支 - `⇣` —— 落后于远程分支 - `⇕` —— 与远程分支存在分歧 - `?` —— 存在未记录的文件 - `$` —— 存在 stash 快照 - `!` —— 存在被修改的文件 - `+` —— 暂存区中存在内容 - `»` —— 文件重命名 - `✘` —— 文件被删除 - 显示当前的 Mercurial 分支 - 显示当前电量剩余与电源状态 - `⇡` —— 电池充电中 - `⇣` —— 电池耗电中 - `•` —— 电池已充满 - 显示后台运行进程数（`✦`） - 显示当前 Kubernetes 集群与命名空间（`☸`） - 显示当前 AWS 配置（`☁️`） - 显示上一条命令的执行用时 - 自定义环境变量值 - Nix-shell 环境检测 - 如果当前用户与不是登录用户，显示当前用户名 - 12/24 小时格式的时间显示（可选） - 显示 Terraform 工作区和当前版本（`💠`） - 显示当前 Conda 环境（`C`） ## 🚀 安装 ### 前置要求 - 安装一种 [Powerline 字体](https://github.com/powerline/fonts)（如 [Fira Code](https://github.com/tonsky/FiraCode)）并在您的终端启用。 ### 开始安装 1. 安装 **starship** 二进制文件： #### 安装最新版本 ##### 下载预构建的二进制文件，使用 Shell 命令： ```sh curl -fsSL https://starship.rs/install.sh | bash ``` ##### 直接从 [crates.io](https://crates.io/) 获取源代码编译： ```sh cargo install starship ``` #### 通过软件包管理器安装 ##### 使用 [Homebrew](https://brew.sh/) ```sh brew install starship ``` ##### 使用 [Scoop](https://scoop.sh)： ```powershell scoop install starship ``` 1. 将初始化脚本添加到您的 shell 的配置文件： #### Bash 在 `~/.bashhrc` 的最后，添加以下内容： ```sh # ~/.bashrc eval "$(starship init bash)" ``` #### Fish 在 `~/.config/fish/config.fish` 的最后，添加以下内容： ```sh # ~/.config/fish/config.fish starship init fish | source ``` #### Zsh 在 `~/.zshrc` 的最后，添加以下内容： ```sh # ~/.zshrc eval "$(starship init zsh)" ``` #### PowerShell 将以下内容添加到`~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1` (或`~/.config/powershell/Microsoft.PowerShell_profile.ps1`，对于 *nix 系统)： ```sh # ~\Documents\PowerShell\Profile.ps1 Invoke-Expression (&starship init powershell) ``` #### Ion 在 `~/.config/ion/initrc` 的最后，添加以下内容： ```sh # ~/.config/ion/initrc eval $(starship init ion) ``` ## 🔧 配置关于如何配置 Starship ，详情请查看我们的[文档](https://starship.rs/config/)。 ## 🤝 贡献我们一直在寻求各种形式的贡献！**不论您的技能水平如何**，您都可以为项目做出贡献。如果您希望快速为项目作出贡献，请尝试解决 [good first issue](https://github.com/starship/starship/labels/🌱%20good%20first%20issue)。 ### 急需 - 👩‍💼 **项目经理** - 我们有一个GitHub项目，有许多未经整理或没有被置于优先地位的新功能，还有许多想法没有被列入 issues。我们需要人来为项目发展方向指路！ - 👩‍🎨 **设计师** - 想制作吸引人的网站吗？太棒了！我们正想要制作一个漂亮的主页，以彰显 Starship 的与众不同。帮助设计 Starship 的品牌是尝试你新点子的一个巨大机会！ - 👩‍💻 **Rust 开发者** - 我们需要符合语言习惯的，高效的代码，需要性能优化与跨平台编译优化……你可以在这里收获_大量_的成果！我 ([@matchai](https://github.com/matchai)) 是一枚 Rust 新手. 快来为我们指点迷津！如果您有兴趣贡献于 Starship，请查看我们的[贡献指南](https://github.com/starship/starship/blob/master/CONTRIBUTING.md)。另外，你可以自由加入我们的 [Discord 服务器](https://discord.gg/8Jzqu3T) 。 👋 ### 贡献者感谢这些优秀的人 ([emoji key](https://allcontributors.org/docs/en/emoji-key))：

_{Matan Kushner} 💻 🎨 🤔 🚇 🚧 👀 ⚠️	_{John Letey} 💻 🤔 👀 ⚠️	_{Tim Mulqueen} 💻 🤔 👀 ⚠️	_{Tiffany Le-Nguyen} 🤔 🚧 👀 📖	_Snuggle 🎨 🤔 🚧 👀	_{Ryan Leckey} 👀	_{Youssef Habri} 💻
_{Kevin Song} 🐛 💻 📖 ⚠️	_{Andrew Dassonville} 🐛 💻	_MaT1g3R 💻 📖 ⚠️	_{André Zanellato} 💻 📖 ⚠️	_{Saghm Rossi} 💻 📖 ⚠️	_{Shu Kutsuzawa} 💻 📖 ⚠️ 🌍	_{Saurav Sharma} 💻 📖
_{Thomas O'Donnell} 💻 ⚠️ 📖 👀	_{Bruno Bigras} 💻 👀	_{Neil Kistner} 💻 ⚠️ 👀	_{Quinn Strahl} 💻 ⚠️	_{Titouan Vervack} 💻 ⚠️	_{Francisco Lopes} 💻	_{Andrew Houts} 💻 📖 ⚠️
_{Nick Young} 💻 📖 ⚠️ 👀	_{Gabriel de Perthuis} 💻	_Hofer-Julian 📖	_{Yuji Ueki} 🖋 🌍	_谢祯晖 💻 📖 🌍 👀	_{Kutsuzawa Ryo} 👀 💻 ⚠️ 🌍	_hdevalke 🤔
_{Kuba Clark} 💻 📖 ⚠️	_Gimbar 💻 ⚠️ 📖	_{Tom Hotston} 💻 📖	_{Bijan Chokoufe Nejad} 💻 ⚠️ 👀	_yuri 💻 📖 ⚠️	_{TsubasaKawajiri} 🌍	_{Ryo Yamashita} 💻
_{Thomas Lee} 💻	_(´⌣`ʃƪ) 💻	_{Barnaby Keene} 💻	_{Keith Wade} 💻 ⚠️	_LukeAI 📖	_{Zach Mertes} 💻 📖 ⚠️	_{David Knaack} 💻 📖 ⚠️
_{Carl Summers} 📖	_{Yushan Lin} 🌍	_{Weihang Lo} 🌍	_pinshan 🌍	_{Brian Low} 💻 📖 ⚠️	_{Matias Kotlik} 💻	_marblenix 🚇 💻 ⚠️
_Raidou 💻 ⚠️	_{Luca Greco} 💻 📖 ⚠️	_{Luca Rinaldi} 💻	_{Stephen Ball} 💻 ⚠️ 📖	_{Qingping Hou} 💻 📖 ⚠️	_{Dan Wendorf} 💻 ⚠️	_{Alan Pope} 🚇
_BuggStream 💻 📖	_{Jon Grythe Stødle} 💻 ⚠️	_{Jason Etcovitch} 🐛	_{Etienne Mabille} 💻	_{AppleTheGolden} 💻 📖	_{Mike Sampson} 💻 📖 ⚠️	_{Dominik Braun} 💻
_{David Hewson} 💻	_{Gennady Koshkin} 🌍	_{Oleksii Filonenko} 🌍	_{Artem Ivanov} 🌍	_{Peter Bull} 💻 ⚠️	_{Andrew Prokhorenkov} 💻 📖 ⚠️ 📆

此项目遵循 [all-contributors](https://github.com/all-contributors/all-contributors) 标准。任何形式的贡献都将受到欢迎！ ## 💭该项目受以下项目启发请参考这些曾经为 Starship 提供启发的工程。 🙏 - **[denysdovhan/spaceship-prompt](https://github.com/denysdovhan/spaceship-prompt)** - A ZSH prompt for astronauts. - **[denysdovhan/robbyrussell-node](https://github.com/denysdovhan/robbyrussell-node)** - Cross-shell robbyrussell theme written in JavaScript. - **[reujab/silver](https://github.com/reujab/silver)** - A cross-shell customizable powerline-like prompt with icons.

## 📝 License Copyright © 2019-present, [Starship Contributors](https://github.com/starship/starship/graphs/contributors).
This project is [ISC](https://github.com/starship/starship/blob/master/LICENSE) licensed.