blob: 194c5dbad21b024a4846daf4512cc3823498860c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
|
---
layout: home
hero:
image: /logo.svg
text:
tagline: 適合任何 shell 的最小、極速、無限客製化的提示字元！
actions:
-
theme: brand
text: 馬上開始 →
link: ./guide/
features:
-
title: 相容性優先
details: 能夠在最常見的作業系統之中最常見的 shell 上運作。 在各處使用它吧！
-
title: 以 Rust 開發
details: 帶來同類中最快的速度以及 Rust 的安全性，讓你的提示字元盡可能快速與可靠。
-
title: 可客製化
details: 任何些微的細節都可以隨你喜愛地客製化，讓你的提示字元可以隨你所欲地最小化或是充滿各種特色。
footer: ISC Licensed | Copyright © 2019-present Starship Contributors
#Used for the description meta tag, for SEO
metaTitle: "Starship：跨 Shell 提示字元"
description: Starship 是適合任何 shell 的最小、極速、高度客製化的提示字元！ 顯示你需要的訊息，同時保持順暢與最小化。 有針對 Bash、Fish、ZSH、Ion 、Tcsh、Elvish、Nu、Xonsh、Cmd 與 Powershell 的快速安裝指南。
---
<video class="demo-video" muted autoplay loop playsinline>
<source src="/demo.webm" type="video/webm">
<source src="/demo.mp4" type="video/mp4">
</video>
### 先決要求
- 安裝 [Nerd Font](https://www.nerdfonts.com/) 字型，並在終端機中啟用。
### 快速安裝
1. 安裝 **starship** 執行檔：
#### 安裝最新版本
使用 Shell 安裝：
```sh
curl -sS https://starship.rs/install.sh | sh
```
如果想更新已安裝的 Starship，請重新執行上述指令。 指令只會更新 Starship 執行檔本身，不會影響到任何已撰寫的設定檔。
#### 使用套件管理器安裝：
使用 [Homebrew](https://brew.sh/)：
```sh
brew install starship
```
使用 [Winget](https://github.com/microsoft/winget-cli)：
```powershell
winget install starship
```
1. 將初始化腳本 (script) 加入你的 shell 的設定檔：
#### Bash
將以下內容放到 `~/.bashrc` 的結尾：
```sh
# ~/.bashrc
eval "$(starship init bash)"
```
#### Fish
將以下內容放到 `~/.config/fish/config.fish` 的結尾：
```sh
# ~/.config/fish/config.fish
starship init fish | source
```
#### Zsh
將以下內容放到 `~/.zshrc` 的結尾：
```sh
# ~/.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`。
```sh
Invoke-Expression (&starship init powershell)
```
#### Ion
將以下內容放到 `~/.config/ion/initrc` 的結尾：
```sh
# ~/.config/ion/initrc
eval $(starship init ion)
```
#### Elvish
::: warning
只有支援 elvish v0.18 或以上版本。
:::
將以下內容放到 `~/.elvish/rc.elv` 的結尾：
```sh
# ~/.elvish/rc.elv
eval (starship init elvish)
```
#### Tcsh
將以下內容放到 `~/.tcshrc` 的結尾：
```sh
# ~/.tcshrc
eval `starship init tcsh`
```
#### Nushell
::: warning
這項設定未來會改變。 只有支援 Nushell v0.78+。
:::
新增下列內容至你的 Nushell env 檔案中的最下方（在 Nushell 執行 `$nu.env-path` 找到它）。
```sh
mkdir ~/.cache/starship
starship init nu | save -f ~/.cache/starship/init.nu
```
新增下列的內容至你的 Nushell 設定檔最下方（執行 `$nu.config-path` 找到它）：
```sh
use ~/.cache/starship/init.nu
```
#### Xonsh
將以下內容加到 `~/.xonshrc` 的結尾：
```sh
# ~/.xonshrc
execx($(starship init xonsh))
```
#### 命令提示字元
您需要在 Cmd 中使用 [Clink](https://chrisant996.github.io/clink/clink.html) (v1.2.30+)。 新增下列的內容到檔案 `starship.lua` 中並將這個檔案存放在 Clink scripts 的路徑下方：
```lua
-- starship.lua
load(io.popen('starship init cmd'):read("*a"))()
```
|
