每次打开终端，第一眼看到的那行user@host:~$并不是 Bash 随手画的装饰，而是它专门用整整一节来讲的特性——Bash Features 里的 Controlling the Prompt。我第一次认真啃这节内容，是因为配坏了一次 PS1：提示符里颜色、路径、git 分支全混在一起，结果光标像抽风一样在屏幕上乱跳，敲一个长命令就换行错乱，最后只能开另一个终端来救场。后来把文档啃完才发现，提示符根本不是“能显示就好”的小事，它是一个信息密度极高的窗口，也是你每天要看好几百遍的东西。这篇就把 PS1 到 PS4、转义序列、颜色规则、动态命令、PROMPT_COMMAND，以及一套可以直接抄作业的生产级配置全拆开讲清楚。适合刚学 Bash 想提升终端体验的朋友，也适合已经用了一段时间、但从来没细抠过提示符细节的开发者。
1. 先搞清楚提示符从哪里来：PS1 到 PS4 各管什么
1.1 你看到的那个提示符，本质是一个环境变量
在 Bash 里，主提示符的内容由一个叫PS1的变量决定。你可以把它理解成“提示符模板字符串”。Bash 在等你输入命令之前，会先读取这个变量、做一轮展开，然后把结果打印到终端上。也就是说，你看到的user@host:~$并不是写死的，你可以随时重新赋值。
最简单的验证方法就是在终端里直接敲：
PS1="hello> "回车之后，提示符立刻变成hello>，等下一次命令结束又会恢复成原来的样子。为什么？因为这种赋值只作用于当前 shell，等你重新登录或者打开新的终端窗口，系统又回到~/.bashrc里定义的默认值。
所以真正要让配置长期生效，就得把 PS1 的赋值写进~/.bashrc。这里有个很容易忽略的点：~/.bashrc是交互式 shell 启动时执行的脚本，非交互式 shell（比如直接跑bash script.sh）根本不会加载它，也不会显示提示符。这一点后面排查问题时会反复用到。
1.2 PS2、PS3、PS4 都是干什么的
很多人以为提示符就是那个主提示符，其实 Bash 一共有四个提示符变量，每一个的职责都不一样。
| 变量 | 默认值 | 用途 |
|---|---|---|
| PS1 | \s-\v\$ | 主提示符，shell 等待你输入命令时显示 |
| PS2 | > | 续行提示符，命令没写完被折行时显示 |
| PS3 | #? | select命令的交互菜单提示符 |
| PS4 | + | bash -x调试模式下每条命令前面的前缀 |
这里面最容易感知到的是 PS2。你没写完后半句引号、或者用反斜杠换行继续写命令时，提示符会变成>，那就是 PS2 在提醒你“这条命令还没结束”。我见过有人把 PS2 改成...的，一眼就能看出命令处于续行状态，体验会好一些。
PS3 很少有人去动，但如果你写过带菜单的脚本，比如让用户从几个选项里挑一个执行，用的就是 PS3 提示符。PS4 则是在bash -x跟踪执行时出现的调试前缀，日常使用频率不高。
这四兄弟里面，真正的重头戏只有 PS1，后面对颜色、动态内容的控制，绝大多数都围绕它展开。
1.3 交互式 Shell 的加载链路
搞清楚配置为什么生效，要先知道交互式 Bash 启动时做了什么。登录 shell 会先读系统级配置和~/.bash_profile（有些发行版会间接 source~/.bashrc），而新的交互式 shell 则直接读~/.bashrc。简单说，只要你想让提示符改动全局生效，把它扔进~/.bashrc就不会错。
还有一个技巧：改完.bashrc不必重新登录，直接执行source ~/.bashrc就能在当前窗口里让新配置生效。如果不执行 surface，当前终端的 PS1 还是旧值，这种情况会让很多人误以为自己改错了。
2. 提示符里能放什么：转义序列与颜色控制速查
2.1 高频转义序列速查表
PS1 最强大的地方在于，它支持一套反斜杠转义序列，Bash 会在显示前把它们替换成实际内容。这就像餐厅门口的菜单牌，不光能写“今日套餐”，还能把价格、营业时间、当日天气都标上去。
| 转义序列 | 含义 | 示例输出 |
|---|---|---|
\u | 当前用户名 | user |
\h | 主机名（不含域名部分） | host |
\H | 完整主机名 | host.example.com |
\w | 当前目录完整路径，$HOME缩写为~ | ~/projects |
\W | 当前目录最后一段 | projects |
\d | 日期，格式为“星期 月 日” | Fri Mar 14 |
\t | 24 小时制时间，含秒 | 14:32:05 |
\A | 24 小时制时间，不含秒 | 14:32 |
\T | 12 小时制时间，含秒 | 02:32:05 |
\@ | 12 小时制时间，不含秒 | 02:32 PM |
\D{格式} | 自定义日期格式，按strftime语法 | \D{%Y-%m-%d}→2025-03-14 |
\$ | root 用户显示#，普通用户显示$ | $ |
\# | 当前这条命令的编号 | 42 |
\! | 当前命令的历史记录编号 | 1024 |
\n | 换行 | 换行 |
\\ | 反斜杠本身 | \ |
\[ | 开始标记一段非打印字符 | — |
\] | 结束标记一段非打印字符 | — |
\$这个转义序列非常实用。它自动区分 root 和普通用户，避免你开着 root 窗口却还看到$，误以为自己是普通用户。反过来，普通用户也一眼能看出自己的权限状态。
2.2 ANSI 颜色规则并没有那么复杂
提示符配色的底层机制是 ANSI 转义码。终端看到\e[31m，就知道后面输出的字符用红色显示，看到\e[0m就恢复默认颜色。规则很简单：\e[开头，接上一个或多个用分号隔开的控制码，最后加一个m。
8 种基本颜色的编号如下：
| 颜色 | 前景色 | 背景色 |
|---|---|---|
| 黑 | 30 | 40 |
| 红 | 31 | 41 |
| 绿 | 32 | 42 |
| 黄 | 33 | 43 |
| 蓝 | 34 | 44 |
| 品红 | 35 | 45 |
| 青 | 36 | 46 |
| 白 | 37 | 47 |
除了颜色本身，还有几个常用的显示属性：0重置全部属性，1加粗，4下划线，7反色。注意加粗在某些终端里会改变颜色亮度，所以很多人喜欢用\e[1;32m表示“亮绿色加粗”，实际效果比纯32更醒目。
组合规则很容易理解：把属性和颜色码用分号拼在一起，比如前景红色加粗就是\e[1;31m，蓝色加粗就是\e[1;34m。如果要用背景色，就再把背景色码加进去，比如\e[1;31;43m是红字黄底。
还有一点值得提：现代终端还支持 256 色（\e[38;5;Nm）甚至真彩色（\e[38;2;R;G;Bm），但兼容性参差不齐。做通用配置时，用 8 色加粗组合是最稳妥的方案。
2.3\[ \]这对括号是保命符
这是提示符里最容易被忽略、却最要命的一对转义序列。它的作用是告诉 Bash：括号之间的内容是不占屏幕宽度的“隐形字符”，比如颜色转义码。
为什么这么重要？因为 Bash 在计算提示符宽度时，默认把每个字符都按等宽字符来计算。而 ANSI 颜色码本身并不会在屏幕上画出任何可见字符，如果不用\[ \]包住，Bash 会把它们也计入宽度。一旦命令跑到终端最右侧需要换行，Readline（Bash 的行编辑器）就会算错位置，导致光标重叠、命令行显示混乱。
打个比方：你贴贴纸的时候，贴纸本身有厚度，但贴纸的离型纸不该算进展示尺寸。\[和\]就是提醒 Bash 把离型纸的部分忽略掉。我在第一次配带颜色的提示符时就踩过这个坑，后来养成一个习惯：所有 ANSI 码一律用\[\e[...m\]包裹，任何例外都不接受。
3. 让提示符动态起来：命令替换与 PROMPT_COMMAND
3.1 在 PS1 里执行命令的时机和代价
PS1 不光支持转义序列，还支持命令替换。也就是说，你可以把一条命令的输出直接放进提示符里。写法就是在 PS1 里嵌入$(命令)，Bash 会在每显示一次提示符之前执行它。
最常见的场景是显示 git 分支：
PS1='\u@\h:\w$(git branch --show-current 2>/dev/null)\$ '但这里有个非常隐蔽的坑：如果你用双引号给 PS1 赋值，比如PS1="...$(git branch...)"，那$(...)会在赋值那一刻就执行一次，之后提示符永远显示当时的旧分支。正确做法是用单引号赋值，让命令替换延迟到每次显示提示符时才执行。单引号里$(...)是字面量，Bash 解析 PS1 时才展开。
命令替换会给每条命令增加额外开销。git branch在大仓库里可能要到一两百毫秒，如果你每条命令间隙都卡一下，用户体验会很糟。后面第 4 章会讲怎么用缓存优化。
3.2 PROMPT_COMMAND 能做哪些 PS1 做不了的事
PROMPT_COMMAND是另一个配套变量，它的值是一条命令（通常是函数调用），Bash 会在每次显示 PS1 之前执行它。它和 PS1 的差别在于：PS1 负责“渲染”，PROMPT_COMMAND 负责“干活”。
我目前最常用的场景有三个。
第一个是修改终端标题栏：
PROMPT_COMMAND='printf "\033]0;%s@%s:%s\007" "$USER" "$HOSTNAME" "${PWD/#$HOME/~}"'这样终端窗口的标题会实时显示当前用户、主机和路径，配合终端的分组管理非常好用。
第二个是捕获上一条命令的退出码。这里有个细节：$?一旦被其他命令执行就会覆盖，所以必须在 PS1 展开之前先保存。PROMPT_COMMAND 正好在 PS1 之前执行，可以在里面做：
PROMPT_COMMAND='ret=$?'然后 PS1 里引用$ret这个变量。注意，ret=$?本身也是一条赋值命令，执行后$?会变成 0，但$ret的值已经被保存住了。
第三个是动态切换整个提示符的配色。比如上一条命令失败时，把整个提示符变成红色：
PROMPT_COMMAND='ret=$?; if [ $ret -ne 0 ]; then PS1="\\[\\e[1;31m\\]\\u\\$ "; else PS1="\\[\\e[1;32m\\]\\u\\$ "; fi'这种写法等于在每条命令后重新生成 PS1，灵活度很高，但开销也大，建议只在你确实需要时才用。
3.3 动态显示命令退出状态
我比较推荐的做法是在 PS1 里放一个函数调用，而不是直接写一长串命令，这样可维护性好很多。
function __last_status { local code=$? if [[ $code -ne 0 ]]; then printf '[%d]' "$code" fi } PS1='\u@\h:\w$(__last_status)\$ '注意这里$?的取值时机：命令替换在 PS1 展开时发生，__last_status函数开头拿到的$?，正是上一条用户命令的退出码。如果这个函数放的不是第一个命令替换，返回值就不可靠了，这也是实际配置时容易搞乱的地方。
在提示符里看到一个非零的退出码，比你在命令输出里翻半天“到底成没成功”要高效得多。我见过很多开发者都把这个作为标配，尤其是频繁编译、部署的人。
4. 从零组装一套生产级提示符：完整配置与验证
4.1 先定需求再动手
在写配置之前，我习惯先把需求列清楚。这里我想实现四个目标：
- 一眼能区分用户名、路径、系统状态；
- 在 git 仓库目录里显示当前分支；
- 上一条命令失败时，显示退出码；
- 普通用户和 root 的提示符标识能自动区分。
这个方案不需要第三方工具，也不需要额外安装东西，纯 Bash 就能实现。
4.2 完整配置代码
下面这段配置建议放到~/.bashrc末尾。先定义一个 git 分支函数和一个退出状态函数：
# 显示 git 分支名（如果有） function __git_ps1_branch { local b b=$(git branch --show-current 2>/dev/null) if [[ -n "$b" ]]; then printf '(%s)' "$b" fi } # 显示上一条命令的退出码（非零时） function __last_status { local code=$? if [[ $code -ne 0 ]]; then printf '[%d]' "$code" fi }然后组装 PS1。我这里用单引号赋值，保证$(...)不会在赋值时被执行：
PS1='\[\e[1;32m\]\u\[\e[0m\]@\[\e[1;33m\]\h\[\e[0m\]:\[\e[1;34m\]\w\[\e[0m\]\[\e[1;35m\]$(__git_ps1_branch)\[\e[0m\]\[\e[1;31m\]$(__last_status)\[\e[0m\]\[\e[1;36m\]\$\[\e[0m\] '效果大概是这样的：
user@host:~/projects(my-feature)[1]$其中用户名是绿色、主机名是黄色、路径是蓝色、分支是品红、退出码是红色、结尾的$是青色。每条命令的$?为 0 时，退出码部分不显示，提示符干干净净。
4.3 加载与验证
写入后执行：
source ~/.bashrc然后分别验证几个场景：进入一个 git 仓库目录，看分支是否显示；故意执行一条失败命令（比如ls /nonexistent），看退出码是否出现；执行sudo -s成 root，看提示符末尾是否变成#。
如果这些场景都正常，说明这套配置基本合格了。
4.4 性能与可维护性优化
第 3 章提过，git 分支检测开销不可忽略。如果仓库很大，或者你经常用提示符渲染高频的命令（比如交互式 shell 里的每次回车），我建议加一层简单缓存：只在目录变化时才去查 git。
declare -g __git_cached_branch="" declare -g __git_cached_dir="" function __git_ps1_branch { local cur_dir="$PWD" if [[ "$cur_dir" != "$__git_cached_dir" ]]; then __git_cached_dir="$cur_dir" __git_cached_branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null) [[ -z "$__git_cached_branch" ]] && __git_cached_branch="" fi [[ -n "$__git_cached_branch" ]] && printf '(%s)' "$__git_cached_branch" }这个版本在同目录内不会重复执行 git，性能明显更好。代价是如果你在同一个目录里切换分支（比如拉取了新分支），提示符里的分支名不会立刻更新。这是我权衡过才接受的折中——大多数时候，你在同一目录里做完操作再按回车，分支名才变，这其实影响不大。如果你实在想要实时更新，那就得回到每命令都执行 git 的版本。
关于可维护性，我给自己的建议是：如果配置开始变得很长，就把颜色定义抽成变量，或者直接放到单独的文件里 source。毕竟.bashrc里还有一堆别名和函数，提示符配置单独维护，出问题也好定位。
5. 提示符出问题时怎么排查：常见坑与速查表
5.1 长命令换行错乱、光标重叠
这个问题十有八九是\[ \]没写对。颜色转义码没有用\[ \]包住，Bash 把这些隐形字符当成了可见宽度。
排查方法很简单：把 PS1 里所有颜色码检查一遍，确保每个\e[...m都完整地被\[\]包裹。如果你已经有现成配置但不想逐字看，可以用一个临时简化版 PS1 来验证：
PS1='\[\e[32m\]\u\[\e[0m\]$ '如果这样没乱，说明问题确实出在颜色码定位上。
5.2 提示符里的命令只执行了一次
这个几乎都是赋值时引用方式的问题。双引号赋值会让$(...)立即执行并固化成字符串，正确姿势是单引号赋值，或者用\$()来转义。
我在配置里也经常看到有人这么写：
PS1="\u@\h:\w \$(git branch --show-current) \$"双引号里\$之后的内容会延迟到 PS1 展示时执行。这也可以，但可读性不如单引号，容易写着写着就漏转义。我的习惯是统一用单引号。
5.3 提示符拖慢每条命令
遇到这种问题，先检查 PS1 里命令替换的数量和开销。git branch --show-current、ls这类外部命令每次展示都要起一个子进程，成本就在那里。优化方向有三：去掉不必要的信息、加缓存、或者把高频信息放进 PROMPT_COMMAND 里统一计算。
如果你发现自己配了非常复杂的提示符，每个按键都卡顿，也可以考虑用异步方案，但这已经超出纯 Bash 提示符的范畴了，需要借助外部工具来定期刷新缓存。
5.4 特殊目录名引发的问题
目录名本身可能包含换行符或控制字符，在提示符里会引发不可预料的渲染问题。虽然这种情况极少，但如果你在临时目录里不小心建了带特殊字符的目录，再进到里面时，终端渲染就会被破坏。
稳妥的做法是在函数输出之前做一层过滤，把控制字符去掉：
b=$(git branch --show-current 2>/dev/null) b=${b//[[:cntrl:]]/}这个做法不仅适合分支名，也适合任何插入到 PS1 的不可信字符串。
5.5 常见问题速查表
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
改动.bashrc后没变化 | 没有重新加载配置 | 执行source ~/.bashrc或重新登录 |
| 提示符换行错乱 | ANSI 码未被\[ \]包裹 | 把所有颜色码完整包进\[ \] |
| 动态命令只输出一次 | 双引号赋值导致立即展开 | 改用单引号，或用\$() |
| 每条命令都变卡 | 提示符里外部命令开销过大 | 加缓存，或者去掉低频信息 |
| 非交互式 shell 里出现奇怪颜色 | 脚本和管道里没有 PS1 逻辑 | 确认是否预期行为，用tput做兼容 |
| 终端标题不刷新 | PROMPT_COMMAND 未设置 | 参照第 3 章的 printf 写法 |
5.6 关于兼容性和终端差异
我这里用的\e[是 ANSI 转义码的一种写法，在主流终端模拟器里都能正常工作。如果你想要更强的兼容性，可以改用tput来生成颜色码，tput会根据当前TERM环境变量输出该终端支持的控制码。比如：
C_USER=$(tput setaf 2) C_RESET=$(tput sgr0)用tput的好处是省去自己记颜色编号的麻烦，但输出结果里不含\[ \]，仍然需要手动包一层。很多发行版自带的.bashrc里就有基于tput的彩提示符判断，你可以参考那个写法来做兼容处理。
我个人在实际操作中的体会是：提示符配置不怕写得花，最怕不知道每一步在干什么。你把颜色、动态信息、函数结构拆清楚，出问题时看一眼就能定位；如果把所有东西揉成一长串魔法字符串，那哪天出了问题，排查成本会远远高于你当初省下的那几分钟。还有一个小技巧：每次改完 PS1，先不要急着做其他事，敲几条长短不一的命令测试一下换行行为，确认 Readline 正常工作再收工。改提示符这件事，量不大，但细节确实多，值得花一点时间调成顺手的状态。
