需手动启用并配置 starship 的 jobs 模块以在提示符中显示后台任务数量,支持 bash/zsh/fish,依赖 shell 作业状态检测,可通过 toml 配置显示逻辑、样式、阈值及命令。

如果您在终端中使用 Starship 作为 Shell 提示符,但希望在提示符中显示当前正在运行的后台任务(如通过 jobs 命令可见的挂起或运行中作业),则需手动启用并配置 Starship 的 jobs 模块。Starship 默认不启用该模块,且其行为依赖于 Shell 对作业状态的报告能力(如 Bash/Zsh 的 $? 和 $JOBS 环境变量或内置 jobs 命令输出解析)。以下是实现该功能的具体配置方法:
一、启用 jobs 模块并设置基础显示逻辑
Starship 的 jobs 模块用于在提示符中显示当前 Shell 中活跃的后台作业数量。它仅在检测到至少一个作业时才渲染,且不区分作业状态(运行/挂起),仅统计非空作业列表长度。该模块需显式启用,并可自定义触发阈值与格式。
1、打开 Starship 配置文件:~/.config/starship.toml。
2、在文件末尾添加以下 TOML 片段:
[jobs]
show = true
number_threshold = 1
format = "? [$num]($style) "
style = "bold yellow"
二、适配不同 Shell 的作业状态检测机制
Starship 的 jobs 模块依赖 Shell 提供的作业元数据。Bash 与 Zsh 实现方式不同:Zsh 原生支持 $ZSH_EVAL_CONTEXT 和 $jobstates,而 Bash 仅能通过执行 jobs -r | wc -l 获取运行中作业数。若默认行为未生效,需强制指定检测方式。
1、对于 Zsh 用户,在配置中添加 zsh_only = true 以启用 Zsh 原生状态监听:
[jobs]
zsh_only = true
show = true
2、对于 Bash 用户,禁用 Zsh 专用逻辑并启用命令执行模式:
[jobs]
zsh_only = false
show = true
3、为 Bash 显式指定作业计数命令(需确保命令返回纯数字):
command = "jobs -r 2>/dev/null | wc -l | tr -d ' '"
三、自定义 jobs 模块的视觉反馈与条件触发
为避免提示符在无作业时显示冗余符号,可配置动态显示逻辑:仅当作业数超过阈值、或存在特定状态作业(如已停止但未完成)时才渲染。Starship 支持基于环境变量和命令输出的条件格式化,无需外部脚本介入。
1、设置仅在作业数 ≥ 2 时显示:
number_threshold = 2
2、使用条件格式字符串,使单个作业显示为 ?,多个作业显示为 ?:
format = """[[$num]](bold yellow) $symbol"""
symbol = "?"
[[jobs.symbol]]
when = '[[ $num -gt 1 ]]'
symbol = "?"
3、添加前缀文本以明确语义:
format = "jobs: [[$num]](bold yellow) $symbol "
四、调试 jobs 模块是否正常工作
Starship 不提供内置 jobs 模块日志,但可通过模拟 Shell 环境变量和命令输出验证配置是否被正确解析。关键在于确认 Starship 是否能稳定读取作业数量——若始终显示为 0,说明底层 Shell 未暴露有效作业信息或命令执行失败。
1、在终端中手动运行配置中指定的命令(如 jobs -r | wc -l),确认输出为非负整数。
2、启动一个后台任务:sleep 100 &,再执行 jobs 查看是否列出该任务。
3、重新加载 Starship 配置:starship config 或重启 Shell。
4、观察提示符左侧是否出现预期符号及数字;若无变化,检查 starship explain 输出中 jobs 模块是否被跳过(显示为 disabled)。
五、兼容性增强:为 Fish Shell 添加 jobs 支持
Fish Shell 不提供与 Bash/Zsh 兼容的 jobs 命令语法,其作业管理通过 jobs 内置函数返回结构化输出。Starship 默认不支持 Fish 的 jobs 解析,需通过自定义命令桥接。
1、在 Fish 中创建函数封装作业计数:
function fish_jobs_count
jobs | grep -c 'running\|stopped'
end
2、在 ~/.config/starship.toml 中覆盖 jobs 命令:
[jobs]
command = "fish -c 'fish_jobs_count'"
show = true
3、确保该函数已加载:将函数定义放入 ~/.config/fish/config.fish 并重启 Fish。











