starship/docs/zh-TW/guide

網站 · 安裝 · 設定

                     

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

• **快：**很快 —— 非常非常快！ 🚀
• **可客製化：**全方面定制你的提示字元。
• **通用：**適用於任何 Shell 以及作業系統。
• **智能：**一目了然地顯示相關信息。
• **豐富的功能：**支援所以有你喜歡的工具。
• **易用：**安裝快速 —— 幾分鐘內就可以開始使用。

探索 Starship 文件  ▶

🚀 安裝

先決要求

• 安裝至少一個 Nerd Font 字體，並在終端中啟用（例如，你可以試試 Fira Code Nerd Font）。

入門

**備註：**由於不同平台的數量眾多，下方僅顯示部分已支持平台。 找不到你正在使用的平台？ 我想你可以來額外平台說明看看。

1. 安裝 starship 執行檔：

   安裝最新版本

   從預構建的二進制包，並且使用 Shell 命令：

   sh -c "$(curl -fsSL https://starship.rs/install.sh)"
   

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

   備註 —— 安裝腳本的預設值可以被覆蓋，請使用以下指令查看內置說明。

   sh -c "$(curl -fsSL https://starship.rs/install.sh)" -- --help
   

   使用套件管理器安裝：

   使用 Homebrew：

   brew install starship
   

   使用 Scoop：

   scoop install starship
   

2. 將初始化腳本 (script) 加入你的 shell 的設定檔：

   Bash

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

   # ~/.bashrc
   
   eval "$(starship init bash)"
   

   Fish

   將以下內容放到 ~/.config/fish/config.fish 的結尾：

   # ~/.config/fish/config.fish
   
   starship init fish | source
   

   Zsh

   將以下內容放到 ~/.zshrc 的結尾：

   # ~/.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。

   Invoke-Expression (&starship init powershell)
   

   Ion

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

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

   Elvish

   Warning Only elvish v0.17 or higher is supported. 將以下內容放到 ~/.elvish/rc.elv 的結尾：

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

   Tcsh

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

   # ~/.tcshrc
   
   eval `starship init tcsh`
   

   Xonsh

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

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

   Cmd

   You need to use Clink (v1.2.30+) with Cmd. Add the following to a file starship.lua and place this file in Clink scripts directory:

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

   Nushell

   Warning This will change in the future. 只支援 nu v0.33 以上的版本。 Add the following to your nu config file. 你可以透過在 nu 執行 config path 指令來取得設定檔的位置。

   startup = [
    "mkdir ~/.cache/starship",
    "starship init nu | save ~/.cache/starship/init.nu",
    "source ~/.cache/starship/init.nu"
   ]
   prompt = "starship_prompt"
   

🤝 貢獻

我們歡迎具有各式各樣能力的貢獻者！ 如果你正在尋找容易加入的方法，試試看標註為「good first issue」的 issue。

如果您精通非英語語言，並能協助我們在文檔上的翻譯保持最新狀態，我們會非常感謝！ 如果你想要提供翻譯，可以到 Starship Crowdin 上提交您的翻譯。

如果你對貢獻 Starship 有興趣，請看我們的 貢獻指南 。 另外，請不用客氣加入我們的 Discord 伺服器 並來問候一下。 👋

💭 發想來自

請看之前這些幫助我們創造 Starship 的前任作品。 🙏

• denysdovhan/spaceship-prompt - 給太空人的 ZSH 提示。

• denysdovhan/robbyrussell-node - 使用 Javascript 撰寫的跨 shell robbyrussell 主題。

• reujab/silver - 一個跨 shell、可客製化、像 powerline 的圖案提示字元。

📝 許可

Copyright © 2019-present, Starship Contributors.
這個專案使用 ISC 許可。