Skip to content

適合任何 shell 的最小、極速、無限客製化的提示字元!

先決要求

  • 安裝 Nerd Font 字型,並在終端機中啟用。

快速安裝

  1. 安裝 starship 執行檔:

    安裝最新版本

    使用 Shell 安裝:

    sh
    curl -sS https://starship.rs/install.sh | sh

    如果想更新已安裝的 Starship,請重新執行上述指令。 指令只會更新 Starship 執行檔本身,不會影響到任何已撰寫的設定檔。

    使用套件管理器安裝:

    使用 Homebrew

    sh
    brew install starship

    使用 Winget

    powershell
    winget install starship
  2. 將初始化腳本 (script) 加入你的 shell 的設定檔:

    Bash

    將以下內容放到 ~/.bashrc 的結尾:

    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

    將以下內容放到 Microsoft.PowerShell_profile.ps1 的結尾。 你可以藉由在 PowerShell 查詢 $PROFILE 變數以取得這個檔案的位置。 一般來說,檔案會出現在 ~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1,若是在 -Nix 上,檔案則會出現在 ~/.config/powershell/Microsoft.PowerShell_profile.ps1

    sh
    Invoke-Expression (&starship init powershell)

    Ion

    將以下內容放到 ~/.config/ion/initrc 的結尾:

    sh
    # ~/.config/ion/initrc
    
    eval $(starship init ion)

    Elvish

    WARNING

    只有支援 elvish v0.18 或以上版本。

    將以下內容放到 ~/.elvish/rc.elv 的結尾:

    sh
    # ~/.elvish/rc.elv
    
    eval (starship init elvish)

    Tcsh

    將以下內容放到 ~/.tcshrc 的結尾:

    sh
    # ~/.tcshrc
    
    eval `starship init tcsh`

    Nushell

    WARNING

    這項設定未來會改變。 只有支援 Nushell v0.78+。

    新增下列內容至你的 Nushell env 檔案中的最下方(在 Nushell 執行 $nu.env-path 找到它)。

    sh
    mkdir ~/.cache/starship
    starship init nu | save -f ~/.cache/starship/init.nu

    新增下列的內容至你的 Nushell 設定檔最下方(執行 $nu.config-path 找到它):

    sh
    use ~/.cache/starship/init.nu

    Xonsh

    將以下內容加到 ~/.xonshrc 的結尾:

    sh
    # ~/.xonshrc
    
    execx($(starship init xonsh))

    命令提示字元

    您需要在 Cmd 中使用 Clink (v1.2.30+)。 新增下列的內容到檔案 starship.lua 中並將這個檔案存放在 Clink scripts 的路徑下方:

    lua
    -- starship.lua
    
    load(io.popen('starship init cmd'):read("*a"))()