starship 可通过 character、cmd_duration、custom 和 status 模块实现命令执行状态可视化：character 模块用不同符号和颜色区分成功与失败；cmd_duration 可结合 $status 条件高亮失败耗时；custom 模块配合 preexec 钩子显示精确 exit code；status 模块（v1.15+）专用于非零退出码提示，支持信号名与代码格式化。
如果您在使用 Starship 终端提示符时希望直观识别命令执行结果是否成功，或快速捕获 Shell 命令退出状态码，则需启用并定制其错误状态反馈机制。Starship 本身不直接显示原始 exit code，但可通过 character 模块 和 cmd_duration 模块 的组合实现状态可视化，同时支持自定义错误符号、颜色及条件触发逻辑。以下是多种配置方法：
一、配置 character 模块以区分成功与失败状态
character 模块是 Starship 中负责在提示符末尾显示符号的核心组件，它会根据上一条命令的退出状态码自动切换样式和符号，是最直接的状态指示方式。
1、确保 ~/.config/starship.toml 文件已存在，若不存在则创建：
mkdir -p ~/.config && touch ~/.config/starship.toml
2、在文件中添加或修改 [character] 段落，显式定义 success_symbol 和 error_symbol：
3、设置 success_symbol 使用绿色箭头，error_symbol 使用红色叉号，并启用 bold 样式：
[character]
success_symbol = "[❯](bold green)"
error_symbol = "[✘](bold red)"
vicarious = true
4、保存文件后重启终端或执行 source ~/.bashrc（Bash）/ source ~/.zshrc（Zsh）使配置生效。
二、启用并定制 cmd_duration 模块以关联耗时与失败上下文
cmd_duration 模块默认仅在命令执行时间超过阈值时显示耗时信息，但可结合 condition 或 format 中的变量实现“失败时强制显示”逻辑，辅助定位异常命令。
1、在 starship.toml 中启用该模块并设定基础参数：
[cmd_duration]
min_time = 0
show_milliseconds = true
format = "[$duration]($style) "
2、为失败命令单独添加视觉标记：在 format 字段中嵌入条件判断（Starship v1.14+ 支持 $status 变量）：
format = '''[[$duration]($style) ](if $status != 0 { "red bold" } else { "dimmed" })'''
3、注意：此语法依赖 Starship 版本对 TOML 内联条件的支持，若解析失败，请改用静态 fallback 方式：
format = "[$duration]($style) [($status)](if $status != 0 { 'red bold' } else { 'dimmed' })"
三、添加 custom 模块动态输出上一条命令的 exit code
custom 模块允许运行任意 Shell 命令并将其输出注入提示符，适合精确显示上一条命令的真实 exit code，尤其适用于调试场景。
1、在 starship.toml 中新增 [custom.exit_code] 配置段：
[custom.exit_code]
command = "echo $?"
when = '''test $? -ne 0 || test "$STARSHIP_SHELL" = "zsh"'''
format = "[$output](red bold) "
symbol = "⚠️ "
style = "red bold"
2、由于 $? 在子 shell 中不可靠，需改用更健壮的获取方式：将 exit code 存入环境变量，由 preexec 函数捕获（Zsh/Bash 均需额外 shell 级配置）。
3、在 ~/.zshrc 中添加 preexec hook（Zsh）：
preexec() { LAST_EXIT_CODE=$? }
4、修改 custom.exit_code 的 command 为：command = "echo $LAST_EXIT_CODE"
四、启用 status 模块（v1.15+ 新增）直接显示非零退出码
status 模块专为错误状态设计，仅在上一条命令退出码非零时显示，且支持格式化输出具体数值，无需 custom 模块复杂配置。
1、确认 Starship 版本 ≥ 1.15：starship --version
2、在 starship.toml 中启用并配置 [status]：
[status]
disabled = false
format = "[$symbol$common_meaning$signal_name$exit_code]($style) "
symbole = "? "
style = "red bold"
map_symbol = true
3、设置 exit_code_format 以控制非零码显示精度：
exit_code_format = "[$code](bold red)"
4、启用 signal_name 显示被信号终止的情况（如 SIGKILL → "KILL"）：
show_signal_name = true
