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 容器或無網路環境時,都能在三十秒內親手為自己打造一個清晰順手的工作環境。