16 KiB
適合任何 shell 的最小、極速、無限客製化的提示字元！
- **效率：**很快 – _非常非常_快！ 🚀
- **客製化：**全方面設定你的提示字元。
- **通用性：**適用於任何 Shell 以及作業系統。
- **智慧：**一目了然地顯示相關資訊。
- **豐富的功能：**支援所有你喜歡的工具。
- **易用：**安裝快速 – 幾分鐘內即可開始使用。
🚀 安裝
先決要求
- 至少一個Nerd Font需要已經被安裝，並且在終端模擬器中啓用 (你可以試試看FireCode Nerd Font)。
第一步 安裝 Starship
瀏覽各系統的安裝指示
BSD
透過下列的套件管理器安裝 Starship：
| 發行版本 | 儲存庫 | 說明 |
|---|---|---|
| 任一版本 | crates.io | cargo install starship --locked |
| FreeBSD | FreshPorts | pkg install starship |
| NetBSD | pkgsrc | pkgin install starship |
Linux
為你的系統安裝最新版本：
curl -sS https://starship.rs/install.sh | sh
或者，透過下列的套件管理器安裝 Starship：
| 發行版本 | 儲存庫 | 說明 |
|---|---|---|
| 任一版本 | crates.io | cargo install starship --locked |
| 任一版本 | conda-forge | conda install -c conda-forge starship |
| 任一版本 | Linuxbrew | brew install starship |
| Alpine Linux 3.13+ | Alpine Linux Packages | apk add starship |
| Arch Linux | Arch Linux Extra | pacman -S starship |
| CentOS 7+ | Copr | dnf copr enable atim/starship dnf install starship |
| Gentoo | Gentoo Packages | emerge app-shells/starship |
| Manjaro | pacman -S starship |
|
| NixOS | nixpkgs | nix-env -iA nixpkgs.starship |
| openSUSE | OSS | zypper in starship |
| Void Linux | Void Linux Packages | xbps-install -S starship |
macOS
為你的系統安裝最新版本：
curl -sS https://starship.rs/install.sh | sh
或者，透過下列的套件管理器安裝 Starship：
| 儲存庫 | 說明 |
|---|---|
| crates.io | cargo install starship --locked |
| conda-forge | conda install -c conda-forge starship |
| Homebrew | brew install starship |
| MacPorts | port install starship |
Windows
透過發布區中的 MSI 安裝程式為你的系統安裝最新版本：
透過下列的套件管理器安裝 Starship：
| 儲存庫 | 說明 |
|---|---|
| crates.io | cargo install starship --locked |
| Chocolatey | choco install starship |
| conda-forge | conda install -c conda-forge starship |
| Scoop | scoop install starship |
| winget | winget install --id Starship.Starship |
第二步 設定您的 shell 以啟用 Starship
設定您的 shell 以啟用 Starship。 請從下列選單選取您的 shell：
Bash
將以下內容放到 ~/.bashrc 的結尾：
eval "$(starship init bash)"
命令提示字元
您需要在 Cmd 中使用 Clink (v1.2.30+)。 在此路徑 %LocalAppData%\clink\starship.lua 建立一個檔案，並填入以下內容：
load(io.popen('starship init cmd'):read("*a"))()
Elvish
將以下內容放到 ~/.elvish/rc.elv 的結尾：
eval (starship init elvish)
注意：只支援 Elvish v0.18+ 以上的版本
Fish
將以下內容放到 ~/.config/fish/config.fish 的結尾：
starship init fish | source
Ion
將以下內容放到 ~/.config/ion/initrc 的結尾：
eval $(starship init ion)
Nushell
新增下列內容至你的 Nushell env 檔案中的最下方（在 Nushell 執行 $nu.env-path 找到它）。
mkdir ~/.cache/starship
starship init nu | save -f ~/.cache/starship/init.nu
新增下列的內容至你的 Nushell 設定檔最下方（執行 $nu.config-path 找到它）：
use ~/.cache/starship/init.nu
Note: Only Nushell v0.78+ is supported
PowerShell
新增下列的內容至你的 PowerShell 設定檔最下方（執行 $PROFILE 找到它）：
Invoke-Expression (&starship init powershell)
Tcsh
將以下內容放到 ~/.tcshrc 的結尾：
eval `starship init tcsh`
Xonsh
將以下內容加到 ~/.xonshrc 的結尾：
execx($(starship init xonsh))
Zsh
將以下內容放到 ~/.zshrc 的結尾：
eval "$(starship init zsh)"
第三步 設定 Starship
開啟一個新的 shell，您應該可以看到新的美麗 shell 提示字元。 若您對預設值感到滿意，盡情享受！
如果您想要更加客製化 Startship ：
🤝 貢獻
我們歡迎具有各式各樣能力的貢獻者！ 如果你正在尋找容易加入的方法，試試看標註為「good first issue」的 issue。
如果您精通非英語語言，並能協助我們在文檔上的翻譯保持最新狀態，我們會非常感謝！ 如果你想要提供翻譯，可以到 Starship Crowdin 上提交您的翻譯。
如果你對貢獻 Starship 有興趣，請看我們的 貢獻指南 。 另外，請不用客氣加入我們的 Discord 伺服器 並來問候一下。 👋
💭 發想來自
請看之前這些幫助我們創造 Starship 的前任作品。 🙏
-
denysdovhan/spaceship-prompt – 一個給太空人用的 ZSH 提示符號。
-
denysdovhan/robbyrussell-node – 使用 JavaScript 寫出的跨終端機 robbyrussell 主題。
-
reujab/silver - 一個跨 shell、可客製化、像 powerline 的圖案提示符號。
❤️ 贊助我們
你可以成爲一個贊助者來支持這個專案！ 你的名字和頭像會在這裏顯示，並且會帶有一個前往你網站的鏈接。
📝 許可
Copyright © 2019-present, Starship Contributors.
這個專案使用 ISC 許可。