Bash Prompt (PS1) 與 ANSI 顏色完全指南:從跳脫序列、256 色到換行破版防坑實戰
對於每天必須長時間與終端機(Terminal)打交道的工程師而言,命令提示字元(Command Prompt)就像是我們數位工作桌面的門面。
預設的 Bash 提示字元通常是單調死板的黑底白字:
username@hostname:~$
這種配置不僅缺乏視覺焦點,在長時間排查多個伺服器或深層路徑時,更容易因為缺乏層次而導致視覺疲勞。
透過 Bash 的 PS1 環境變數 與 ANSI 跳脫字元(ANSI Escape Sequences),我們能為提示字元注入鮮明的色彩、即時的時間戳記、動態 Git 分支資訊,甚至是前一道指令是否執行成功的狀態指示。
一、認識 Bash 提示字元家族與 PS1
在 Bash 中,終端機的提示文字是由一組 PS(Prompt String)環境變數所控制的:
PS1(Primary Prompt):主提示字元,即每次等待使用者輸入指令時顯示的字串(我們最常自訂的變數)。PS2(Secondary Prompt):次提示字元,當輸入多行指令尚未結束時顯示(預設為>)。PS3(Selection Prompt):Shell 腳本中select迴圈的選單提示字元。PS4(Trace Prompt):使用set -x除錯模式時,印在每一道執行指令前的提示(預設為+)。
通常我們會在家目錄的 ~/.bashrc(或 macOS 的 ~/.bash_profile)中設定:
export PS1="your_custom_prompt"
常用跳脫序列(Escape Sequences)速查表
在 PS1 字串中,可以使用以反斜線 \ 開頭的特殊代碼來動態注入系統狀態:
| 代碼 | 說明 | 輸出範例 |
|---|---|---|
\u |
當前登入的使用者帳號名稱 | starck |
\h |
主機名稱(只取第一個小數點前的前綴) | web-server |
\H |
完整主機名稱(FQDN) | web-server.internal.lan |
\w |
當前工作目錄的完整路徑(家目錄縮寫為 ~) |
~/works/blog |
\W |
當前工作目錄的最後一個資料夾名稱(Basename) | blog |
\t |
當前時間(24 小時制 HH:MM:SS) |
17:30:15 |
\A |
當前時間(24 小時制 HH:MM) |
17:30 |
\d |
當前日期(格式為 Weekday Month Day) |
Mon Nov 4 |
\$ |
權限識別符:一般使用者為 $,若切換為 root 則自動變為 # |
$ 或 # |
\# |
當前 Shell 階段輸入的第幾個指令編號 | 42 |
\! |
該指令在歷史記錄(History)中的編號 | 1024 |
二、解構 ANSI 跳脫序列(SGR 色彩代碼)
終端機如何知道「從這裡開始文字要變成綠色」?答案是 ANSI 跳脫序列(ANSI Escape Sequences)。
在終端機標準中,控制字元外觀的語法稱為 SGR(Select Graphic Rendition):
flowchart LR
ESC["跳脫起始符<br/>\\e[ 或 \\033["] --> STYLE["樣式代碼<br/>0 (正常) / 1 (粗體) / 4 (底線)"]
STYLE --> SEMI[";"]
SEMI --> COLOR["顏色代碼<br/>32 (綠色) / 34 (藍色)"]
COLOR --> ENDM["結束標記<br/>m"]
ENDM --> TEXT["欲顯示文字內容"]
TEXT --> RESET["顏色重設<br/>\\e[0m"]
1. 樣式代碼(Text Attributes)
0:重置所有屬性(Normal / Reset)1:粗體(Bold) 或高亮2:微弱 / 暗淡(Dim / Faint)4:底線(Underline)5:閃爍(Blink,部分終端機不支援)7:反轉顏色(Reverse,前景色與背景色對調)
三、標準 16 色與擴展 256 色對照
1. 標準 16 色(前景色 30–37,背景色 40–47)
# 語法:\e[<樣式>;<顏色>m
\e[0;30m # 黑色 (Black)
\e[0;31m # 紅色 (Red)
\e[0;32m # 綠色 (Green)
\e[0;33m # 黃色 (Yellow)
\e[0;34m # 藍色 (Blue)
\e[0;35m # 紫色 (Magenta / Purple)
\e[0;36m # 青色 (Cyan)
\e[0;37m # 白色 (White)
# 粗體或高亮度 (Bold / Bright)
\e[1;31m # 粗體紅
\e[1;32m # 粗體綠
\e[1;33m # 粗體黃
# 背景顏色 (Background 40-47)
\e[41m # 紅色背景
\e[42m # 綠色背景
\e[44m # 藍色背景
# 重置代碼 (極為重要!必須在字串尾端重設,否則顏色會滲透到後續輸入)
\e[0m # 重置所有顏色與樣式
2. 擴展 256 色(8-bit Color)
現代終端機普遍支援 ANSI 256 色,能提供細膩的過渡色調:
- 前景色(文字):
\e[38;5;<編號>m - 背景色:
\e[48;5;<編號>m
256 色包含:
0–15:標準 16 色。16–231:6 × 6 × 6 的 RGB 色彩立方體(例如148是非常漂亮的草綠色)。232–255:由黑到白的 24 階灰階色調。
你可以使用這段一行指令在終端機印出所有 256 色編號:
for i in {0..255}; do printf "\x1b[38;5;${i}mcolour%-5i\x1b[0m" $i; if [ $(( (i + 1) % 8 )) -eq 0 ]; then echo; fi; done
四、終端機第一大坑:指令過長換行破版(The Readline Bug)
許多開發者在客製化 PS1 時,都會遇到一個詭異的靈異現象:
當輸入一串很長的指令時,文字還沒碰到視窗右邊緣,就莫名其妙跳回同一行最前面,覆蓋掉了原本的提示文字;或者按上下鍵查看歷史指令時,游標位置完全錯亂!
罪魁禍首:Readline 的物理寬度計算
終端機背後的行編輯程式庫 Readline 在計算「何時該折行(Wrap line)」以及「游標當前停在第幾欄」時,必須精確知道提示字元的可見字符長度(Visible Length)。
像 \e[0;32m 這樣的顏色跳脫碼雖然在螢幕上是零寬度(不可見),但如果沒有特殊標記,Readline 會把它當作 7 個一般字符計算,導致內部欄位計數器失真,引發嚴重的游標折行錯位!
解法:一律使用 \[ 與 \] 包裹所有非列印字符
# ❌ 錯誤寫法(未包裹顏色代碼,長指令必破版):
export PS1="\e[0;32m\u@\h\e[0m:\w\$ "
# ✅ 正確寫法(用 \[ 與 \] 將每個顏色序列包起來):
export PS1="\[\e[0;32m\]\u@\h\[\e[0m\]:\w\$ "
\[ 告訴 Readline:「接下來開始的字元都不佔據視覺空間」,而 \] 代表該非列印序列結束。遵守這項規則,換行錯位問題便能徹底煙消雲散。
五、實戰範例:打造高顏值且實用的現代提示字元
範例 1:作者 2013 年原創經典款(帶雲朵圖示與 256 色)
利用 256 色編號 148(柔和青綠)標示當前目錄,並加上 Unicode 符號:
# 青色雲朵 + 使用者名稱 + 綠色資料夾 + 提示字元
export PS1="\[\e[0;96m\]☁ \[\e[0m\]\u [\[\e[38;5;148m\]\W\[\e[0m\]] \$ "
範例 2:專業 DevOps 款(時間 + 退出狀態指示 + Git 分支)
在生產環境中,我們往往需要知道「上一道指令有沒有執行成功」以及「目前位於哪個 Git 分支」:
# 定義取得 Git 分支的函式
parse_git_branch() {
git branch 2> /dev/null | sed -e '/^[^*]/d' -e 's/* \(.*\)/ (\1)/'
}
# 根據上一道指令的返回碼 ($?) 顯示綠色或紅色箭頭
prompt_status() {
local EXIT="$?"
if [ $EXIT -eq 0 ]; then
echo -e "\[\e[1;32m\]➜\[\e[0m\]"
else
echo -e "\[\e[1;31m\]➜ ($EXIT)\[\e[0m\]"
fi
}
export PROMPT_COMMAND="STATUS_ICON=\$(prompt_status)"
export PS1="\${STATUS_ICON} \[\e[1;34m\]\u@\h\[\e[0m\]:\[\e[1;36m\]\w\[\e[0;33m\]\$(parse_git_branch)\[\e[0m\] \$ "
效果亮點:
- 上一道指令成功時,顯示綠色
➜;若失敗,顯示紅色➜ (錯誤代碼)。 - 在 Git 專案目錄下自動顯示當前分支名稱(如
(main))。 - 主機、路徑與使用者層次分明。
結語
從最底層的 ANSI 跳脫字元到 PS1 變數的精密拼裝,看似微小的命令提示字元,實則是每位工程師掌控終端機的第一步。
如今雖然有諸如 Starship 或 Powerlevel10k 等開箱即用的現代提示工具,但深入理解 PS1、SGR 16/256 色碼以及 \[ \] 寬度補償的底層原理,能讓你在登入任何極簡的 Linux 伺服器、Docker 容器或無網路環境時,都能在三十秒內親手為自己打造一個清晰順手的工作環境。