starship/docs/zh-TW/README.md

home	heroImage	heroText	tagline	actionText	actionLink	features	footer	metaTitle	description
true	/logo.svg		適合任何 shell 的最小、極速、無限客製化的提示字元！	馬上開始 →	./guide/	title details 兼容性優先 能夠在最常見的作業系統之中最常見的 shell 上運作。 在各處使用它吧！ title details 以 Rust 開發 帶來同類中最快的速度以及 Rust 的安全性，讓你的提示字元盡可能快速與可靠。 title details 可客製化 任何些微的細節都可以隨你喜愛地客製化，讓你的提示字元可以隨你所欲地最小化或是充滿各種特色。	ISC Licensed | Copyright © 2019-present Starship Contributors	Starship：跨 Shell 提示字元	Starship 是適合任何 shell 的最小、極速、高度客製化的提示字元！ 顯示你需要的訊息，同時保持順暢與最小化。 Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell.

先決要求

• 安裝至少一個 Nerd Font 字體，並在終端中啟用。

快速安裝

1. 安裝 starship 執行檔：

   安裝最新版本

   使用 Shell 安裝：

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

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

   使用套件管理器安裝：

   使用 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 只有 elvish v0.17 或以上版本才有支援 :::

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

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

   Tcsh

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

   # ~/.tcshrc
   
   eval `starship init tcsh`
   

   Nushell

   ::: warning 這項設定可能在未來改變 只支援 nu v0.33 以上的版本。 ::: 將以下內容放到你的 nu 設定檔裡， 你可以透過在 nu 執行 config path 指令來取得設定檔的位置。

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

   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"))()