| .. | ||
| README.md | ||
適合任何 shell 的最小、極速、無限客製化的提示字元！
- **快：**很快 —— 非常非常快！ 🚀
- **可客製化：**全方面定制你的提示字元。
- **通用：**適用於任何 Shell 以及作業系統。
- **智能：**一目了然地顯示相關信息。
- **豐富的功能：**支援所以有你喜歡的工具。
- **易用：**安裝快速 —— 幾分鐘內就可以開始使用。
🚀 安裝
先決要求
- 安裝至少一個 Nerd Font 字體，並在終端中啟用（例如，你可以試試 Fira Code Nerd Font）。
Step 1. Install Starship
Select your operating system from the list below to view installation instructions:
Android
Install Starship using any of the following package managers:
| Repository | Instructions |
|---|---|
| Termux | pkg install starship |
BSD
Install Starship using any of the following package managers:
| Distribution | Repository | Instructions |
|---|---|---|
| Any | crates.io | cargo install starship --locked |
| FreeBSD | FreshPorts | pkg install starship |
| NetBSD | pkgsrc | pkgin install starship |
Linux
Install the latest version for your system:
sh -c "$(curl -fsSL https://starship.rs/install.sh)"
Alternatively, install Starship using any of the following package managers:
| Distribution | Repository | Instructions |
|---|---|---|
| Any | crates.io | cargo install starship --locked |
| Any | conda-forge | conda install -c conda-forge starship |
| Any | Linuxbrew | brew install starship |
| Any | Snapcraft | snap install starship |
| Alpine Linux 3.13+ | Alpine Linux Packages | apk add starship |
| Arch Linux | Arch Linux Community | pacman -S starship |
| CentOS 7+ | Copr | dnf copr enable atim/starship dnf install starship |
| Fedora 31+ | Fedora Packages | dnf install starship |
| NixOS | nixpkgs | nix-env -iA nixos.starship |
| Gentoo | Gentoo Packages | emerge app-shells/starship |
| Manjaro | pacman -S starship |
|
| NixOS | nixpkgs | nix-env -iA nixpkgs.starship |
| Void Linux | Void Linux Packages | xbps-install -S starship |
macOS
Install the latest version for your system:
sh -c "$(curl -fsSL https://starship.rs/install.sh)"
Alternatively, install Starship using any of the following package managers:
| Repository | Instructions |
|---|---|
| crates.io | cargo install starship --locked |
| conda-forge | conda install -c conda-forge starship |
| Homebrew | brew install starship |
| MacPorts | port install starship |
Windows
Install Starship using any of the following package managers:
| Repository | Instructions |
|---|---|
| crates.io | cargo install starship --locked |
| Chocolatey | choco install starship |
| conda-forge | conda install -c conda-forge starship |
| Scoop | scoop install starship |
Step 2. Setup your shell to use Starship
Configure your shell to initialize starship. Select yours from the list below:
Bash
將以下內容放到 ~/.bashrc 的結尾：
eval "$(starship init bash)"
Cmd
You need to use Clink (v1.2.30+) with Cmd. Create a file at this path %LocalAppData%\clink\starship.lua with the following contents:
load(io.popen('starship init cmd'):read("*a"))()
Elvish
將以下內容放到 ~/.elvish/rc.elv 的結尾：
eval (starship init elvish)
Note: Only Elvish v0.17+ is supported
Fish
將以下內容放到 ~/.config/fish/config.fish 的結尾：
starship init fish | source
Ion
將以下內容放到 ~/.config/ion/initrc 的結尾：
eval $(starship init ion)
Nushell
Add the following to the end of your Nushell configuration (find it by running config path):
startup = [
"mkdir ~/.cache/starship",
"starship init nu | save ~/.cache/starship/init.nu",
"source ~/.cache/starship/init.nu",
]
prompt = "starship_prompt"
PowerShell
Add the following to the end of your PowerShell configuration (find it by running $PROFILE):
Invoke-Expression (&starship init powershell)
Tcsh
將以下內容放到 ~/.tcshrc 的結尾：
eval `starship init tcsh`
Xonsh
將以下內容放到 ~/.xonshrc 的結尾：
execx($(starship init xonsh))
Zsh
將以下內容放到 ~/.zshrc 的結尾：
eval "$(starship init zsh)"
Step 3. Configure Starship
Start a new shell instance, and you should see your beautiful new shell prompt. If you're happy with the defaults, enjoy!
If you're looking to further customize Starship:
-
Configuration – learn how to configure Starship to tweak your prompt to your liking
-
Presets – get inspired by the pre-built configuration of others
🤝 貢獻
我們歡迎具有各式各樣能力的貢獻者！ 如果你正在尋找容易加入的方法，試試看標註為「good first issue」的 issue。
如果您精通非英語語言，並能協助我們在文檔上的翻譯保持最新狀態，我們會非常感謝！ 如果你想要提供翻譯，可以到 Starship Crowdin 上提交您的翻譯。
如果你對貢獻 Starship 有興趣，請看我們的 貢獻指南 。 另外，請不用客氣加入我們的 Discord 伺服器 並來問候一下。 👋
💭 發想來自
請看之前這些幫助我們創造 Starship 的前任作品。 🙏
-
denysdovhan/spaceship-prompt – A ZSH prompt for astronauts.
-
denysdovhan/robbyrussell-node – Cross-shell robbyrussell theme written in JavaScript.
-
reujab/silver – A cross-shell customizable powerline-like prompt with icons.
📝 許可
Copyright © 2019-present, Starship Contributors.
這個專案使用 ISC 許可。