starship/docs/zh-TW/faq/README.md

常見問答

主頁示例圖中的效果是使用哪些配置達成的？

• 終端模擬器：iTerm2
  • 模擬器主題：Minimal
  • 配色方案：Snazzy
  • 字型：FiraCode Nerd Font
• Shell：Fish Shell
  • Fish 設定：matchai's Dotfiles
  • 提示字元：Starship

我該如何做出示例圖中的命令自動補齊效果？

有關補全或是自動補齊的效果，主要是借助你使用的 Shell 本身提供的服務來達成。 而示例中環境是使用 Fish Shell，原生就提供了補全功能。 如果你的環境是使用 Z Shell (zsh)，建議參考一下 zsh-autosuggestions。

最上層的 format 與 <module>.disabled 的功能一樣嗎？

對，他們都可以被用來關閉提示字元中的 module。 如果你單純只是想關閉 modules，推薦使用 <module>.disabled，原因如下所述：

• 明確性：關閉 modules 的動作比在 top level format 標記忽略更爲清楚易懂
• 當 Starship 更新後，新組件能被自動加入到提示字元中

文件中提到 Starship 是跨 shell 的。 為什麼我偏好的 shell 沒有被支持？

Starship 構建方式基本上確立了他應當能支援所有 shell 的基礎。 Starship 的執行檔是不會紀錄狀態且不假設底下是哪種 Shell 的，所以只要你的 Shell 支援客製化命令提示字元以及 shell expansion，就應該要能使用 Starship。

以下是在 bash 上使用 Starship 的簡單例子：

# 從最後一個執行的指令獲得當前 status code
STATUS=$?

# 獲得當前正在執行的工作數量
NUM_JOBS=$(jobs -p | wc -l)

# 設置提示字元的輸出為 `starship prompt`
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"

順帶一提，其中 Starship 針對 Bash shell 的實作 稍微複雜一點，實踐了一些如 Command Duration module 的進階功能，也實踐了確保 Starship 設定能夠與系統上的 Bash 相兼容的功能。

使用以下指令來獲得 starship prompt 支援的所有參數。

starship prompt --help

Starship prompt 會盡可能的使用被提供的上下文參數，但使用者也不一定要提供任何參數。

我要如何在一些配有更舊版本 glibc 的 Linux 發行版上執行 Starship？

如果在你使用的環境 (比如：CentOS 6 或 7) 下使用預編好的 Starship 執行檔時會產生一些像 "version 'GLIBC_2.18' not found (required by starship)" 的內容，你可以在執行安裝指令時嘗試選用不同的函式庫預先編譯而成的 Starship 版本，比如說 musl 而非 glibc，如下所示：

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

我發現一些看不懂或意料外的符號，那是代表什麼意思？

如果你看見了一些不認得的符號，你可以使用 starship explain 來列出當下顯示出的 modules 的解釋。

為什麼我無法在我的提示字元中看到字形符號？

會導致這種狀況，通常是因為系統配置錯誤。 有些 Linux 發行版不支援隨開隨用的字體。 你需要確保：

• 你的當地語言設置為 UTF-8，如 de_DE.UTF-8 或 ja_JP.UTF-8。 如果 LC_ALL 不是 UTF-8，你會需要改變他。
• 你已經安裝一個表情符號字體。 大多數的系統在預設情況下皆有支持表情符號字體，然後有些（尤其 Arch Linux）沒有。 你通常可以透過系統的套件管理器安裝一個表情符號字體 —— noto emoji 是個受歡迎的選擇。
• 你正在使用 Nerd Font。

要測試你的系統，你可以在終端中執行以下指令：

echo -e "\xf0\x9f\x90\x8d"
echo -e "\xee\x82\xa0"

第一行指令應該會顯示一個 snake emoji，同時，第二行指令應該顯示 powerline branch symbol (e0a0)。

如果任何一個符號顯示錯誤，代表你的系統配置仍然是錯誤的。 不幸的是，正確的設置字體有時候是件困難的事。 Discord 上的使用者可能可以提供協助。 如果兩種符號皆正確顯示，但你仍然無法在 starship 中看到他們，請發送 bug 回報！

我要如何從電腦中移除 Starship？

移除 Starship 的過程與安裝過程一樣簡單。

1. 刪除 Shell 的設定檔案 (比如 ~/.bashrc) 中用來初始化 Starship 的部分。
2. 刪除 Starship 的執行檔

如果你是透過套件管理器安裝 Starship 的，請到套件管理器的文件中尋找相關的移除步驟指示。

如果你是透過安裝腳本來安裝 Starship 的，可以執行以下的命令來移除執行檔。

# 定位並且刪除 starship 執行檔
sh -c 'rm "$(which starship)"'