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

網站 · 安裝 · 設定

           

Starship 是一個可以用於任何 shell、極小、極快、可高度客製化的提示字元！
這個提示字元顯示你工作時需要的資訊，同時又順暢又不會打擾你。

🍬 特色

• 如果最近一個指令結束時回傳非零的代碼，提示字元將轉成紅色
• 現在的 Go 版本 (🐹)
• 現在的 Java 版本 (☕)
• 現在的 Node.js 版本 (⬢)
• Current PHP version (🐘)
• 現在的 Python 版本 (🐍)
• 現在的 Ruby 版本 (💎)
• 現在的 Rust 版本 (🦀)
• Current .NET version (•NET)
• 現在資料夾中的組件 (package) 版本 (📦)
  • npm (Node.js)
  • cargo (Rust)
  • poetry (Python)
• 現在的 Git branch 與豐富的程式庫 (repository) 狀態：
  • = — 修改衝突
  • ⇡ — 超前遠端 (remote) branch
  • ⇣ — 落後遠端 (remote) branch
  • ⇕ — 修改發散 (diverge)
  • ? — 修改未追蹤
  • $ — 隱藏的 (stashed) 修改
  • ! — 修改過的檔案
  • + — 新增的檔案
  • » — 重新命名的檔案
  • ✘ — 刪除的檔案
• Current Mercurial branch
• 現在的電池電量與狀態
• ⇡ – charging
• ⇣ – discharging
• • – fully charged
• 標註背景執行的工作 (✦)
• 現在的 Kubernetes 叢集以及名稱空間 (Namespace) (☸)
• Current Amazon Web Services (AWS) profile (☁️)
• Execution time of the last command
• Custom environment variable value
• 偵測 Nix-shell 的環境
• 會在使用者與登入的使用者不同時顯示使用者名稱
• Optional current time in 12/24hr format

🚀 安裝

先決要求

• 一個已經安裝並在你的終端機內啟動的 Powerline 字型 (例如，試試看 Fira Code)。

入門

1. 安裝 starship 執行檔：

   Install Latest Version

   With Shell:

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

   Install via Package Manager

   With Homebrew:

   brew install starship
   

   With 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

   將以下內容放到 ~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1 的結尾 (或是在 -Nix 上的 ~/.config/powershell/Microsoft.PowerShell_profile.ps1)：

   # ~\Documents\PowerShell\Profile.ps1
   Invoke-Expression (&starship init powershell)
   

🔧 設定

關於如何設定 Starship，請看 文件 。

🤝 貢獻

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

高優先需求

• 👩‍💼 專案管理員
  • 我們有一個 GitHub 專案以及許多尚未整理/排序的功能，甚至還有點子尚未被製作成 issue。 Starship 需要有人掌管產品的方向！
• 👩‍🎨 設計師
  • 喜歡製作吸睛的網站？ 超讚！ 我們正在想辦法建立一個漂亮的 landing page 來展示 Starship 的美妙。 幫助設計 Starship 的商標正好是一個試驗新點子的機會！
• 👩‍💻 Rust 開發者
  • 當正在寫慣用的 Rust 程式碼、設計高效的 Rust 程式架構、效能優化、跨平台建置優化、以及其他很多東西時，可以在這裡看到_許多_唾手可得的東西！ 我 (@matchai) 是一個 Rust 新手。 來為我們指出正確的方向吧！

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

貢獻者們

感謝這些優秀的人們 (表情符號索引)：

Matan Kushner 💻 🎨 🤔 🚇 🚧 👀 ⚠️	John Letey 💻 🤔 👀 ⚠️	Tim Mulqueen 💻 🤔 👀 ⚠️	Tiffany Le-Nguyen 🤔 🚧 👀 📖	​Snuggle 🎨 🤔 🚧 👀	Ryan Leckey 👀	Youssef Habri 💻
Kevin Song 🐛 💻 📖 ⚠️	Andrew Dassonville 🐛 💻	MaT1g3R 💻 📖 ⚠️	André Zanellato 💻 📖 ⚠️	Saghm Rossi 💻 📖 ⚠️	Shu Kutsuzawa 💻 📖 ⚠️ 🌍	Saurav Sharma 💻 📖
Thomas O'Donnell 💻 ⚠️ 📖 👀	Bruno Bigras 💻 👀	Neil Kistner 💻 ⚠️ 👀	Quinn Strahl 💻 ⚠️	Titouan Vervack 💻 ⚠️	Francisco Lopes 💻	Andrew Houts 💻 📖 ⚠️
Nick Young 💻 📖 ⚠️ 👀	Gabriel de Perthuis 💻	Hofer-Julian 📖	Yuji Ueki 🖋 🌍	谢祯晖 💻 📖 🌍 👀	Kutsuzawa Ryo 👀 💻 ⚠️ 🌍	hdevalke 🤔
Kuba Clark 💻 📖 ⚠️	Gimbar 💻 ⚠️ 📖	Tom Hotston 💻 📖	Bijan Chokoufe Nejad 💻 ⚠️ 👀	yuri 💻 📖 ⚠️	TsubasaKawajiri 🌍	Ryo Yamashita 💻
Thomas Lee 💻	(´⌣`ʃƪ) 💻	Barnaby Keene 💻	Keith Wade 💻 ⚠️	LukeAI 📖	Zach Mertes 💻 📖 ⚠️	David Knaack 💻 📖 ⚠️
Carl Summers 📖	Yushan Lin 🌍	Weihang Lo 🌍	pinshan 🌍	Brian Low 💻 📖 ⚠️	Matias Kotlik 💻	marblenix 🚇
Raidou 💻 ⚠️	Luca Greco 💻 📖 ⚠️	Luca Rinaldi 💻	Stephen Ball 💻 ⚠️ 📖	Qingping Hou 💻 📖 ⚠️	Dan Wendorf 💻 ⚠️

這個專案遵守 all-contributors 規範。 歡迎任何種類的貢獻者！

💭 發想來自

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

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

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

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

📝 許可

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