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

網站 · 安裝 · 設定

                       

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

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

探索 Starship 文件  ▶

🚀 安裝

先決要求

• 至少一個Nerd Font需要已經被安裝，並且在終端模擬器中啓用 (你可以試試看FireCode Nerd Font)。

第一步 安裝 Starship

瀏覽各系統的安裝指示

Android

透過下列的套件管理器安裝 Starship：

儲存庫	說明
Termux	pkg install starship

BSD

透過下列的套件管理器安裝 Starship：

發行版本	儲存庫	說明
任一版本	crates.io	cargo install starship --locked
FreeBSD	FreshPorts	pkg install starship
NetBSD	pkgsrc	pkgin install starship

Linux

為你的系統安裝最新版本：

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

或者，透過下列的套件管理器安裝 Starship：

發行版本	儲存庫	說明
任一版本	crates.io	cargo install starship --locked
任一版本	conda-forge	conda install -c conda-forge starship
任一版本	Linuxbrew	brew install starship
Alpine Linux 3.13+	Alpine Linux Packages	apk add starship
Arch Linux	Arch Linux Extra	pacman -S starship
CentOS 7+	Copr	dnf copr enable atim/starship dnf install starship
Gentoo	Gentoo Packages	emerge app-shells/starship
Manjaro		pacman -S starship
NixOS	nixpkgs	nix-env -iA nixpkgs.starship
openSUSE	OSS	zypper in starship
Void Linux	Void Linux Packages	xbps-install -S starship

macOS

為你的系統安裝最新版本：

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

或者，透過下列的套件管理器安裝 Starship：

儲存庫	說明
crates.io	cargo install starship --locked
conda-forge	conda install -c conda-forge starship
Homebrew	brew install starship
MacPorts	port install starship

Windows

透過發布區中的 MSI 安裝程式為你的系統安裝最新版本：

透過下列的套件管理器安裝 Starship：

儲存庫	說明
crates.io	cargo install starship --locked
Chocolatey	choco install starship
conda-forge	conda install -c conda-forge starship
Scoop	scoop install starship
winget	winget install --id Starship.Starship

第二步 設定您的 shell 以啟用 Starship

設定您的 shell 以啟用 Starship。 請從下列選單選取您的 shell：

Bash

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

eval "$(starship init bash)"

命令提示字元

您需要在 Cmd 中使用 Clink (v1.2.30+)。 在此路徑 %LocalAppData%\clink\starship.lua 建立一個檔案，並填入以下內容：

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

Elvish

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

eval (starship init elvish)

注意：只支援 Elvish v0.18+ 以上的版本

Fish

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

starship init fish | source

Ion

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

eval $(starship init ion)

Nushell

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

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

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

use ~/.cache/starship/init.nu

Note: Only Nushell v0.78+ is supported

PowerShell

新增下列的內容至你的 PowerShell 設定檔最下方（執行 $PROFILE 找到它）：

Invoke-Expression (&starship init powershell)

Tcsh

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

eval `starship init tcsh`

Xonsh

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

execx($(starship init xonsh))

Zsh

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

eval "$(starship init zsh)"

第三步 設定 Starship

開啟一個新的 shell，您應該可以看到新的美麗 shell 提示字元。 若您對預設值感到滿意，盡情享受！

如果您想要更加客製化 Startship ：

• 設定：學習如何設定 Starship 來微調提示字元的外觀

• 其他預設組態：從別人的設定當中獲得啟發

🤝 貢獻

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

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

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

💭 發想來自

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

• denysdovhan/spaceship-prompt – 一個給太空人用的 ZSH 提示符號。

• denysdovhan/robbyrussell-node – 使用 JavaScript 寫出的跨終端機 robbyrussell 主題。

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

❤️ 贊助我們

你可以成爲一個贊助者來支持這個專案！ 你的名字和頭像會在這裏顯示，並且會帶有一個前往你網站的鏈接。

🔒 Code Signing Policy

Free code signing provided by SignPath.io, certificate by SignPath Foundation.

Code Signing Roles:

• Reviewers: Astronauts
• Approvers and Authors: Mission Control

This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.

📝 許可

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