Omarchy 的极简 Starship Shell 提示符默认配置逐项拆解与自定义指南【免费下载链接】omarchyBeautiful, Modern Opinionated Linux项目地址: https://gitcode.com/GitHub_Trending/om/omarchyOmarchy 作为一款注重“美观、现代且固执己见”的 Linux 发行版其交互式 Shell 默认使用 Starship 为对象逐项解释这份出厂配置的设计意图与每个参数的实际含义并给出在~/.config/starship.toml上安全扩展、恢复默认与随版本升级的行为边界帮助你在“够用”与“够好看”之间找到自己的平衡点。本文对应官方用户手册的第 40 章manual/40-prompt.md并延伸到仓库中实际落地这份配置的源码、打包与升级逻辑。为什么 Omarchy 默认只放“三件套”原文档对手册作者个人的 prompt 观有一段很直白的说明默认提示符不需要显示用户名因为使用机器的总是同一个人也不需要显示时间因为时间永远在屏幕顶部的顶栏里。这正是 Omarchy 的设计取舍——把信息放到它该在的地方让终端提示符保持克制。从仓库携带的出厂配置 config/starship.toml 顶层format可以印证这一点format $directory$git_branch$git_status$character也就是说默认 prompt 只由三个模块拼成模块显示内容作用$directory当前目录含 Git 仓库根目录与截断处理告诉你“我在哪”$git_branch当前 Git 分支名告诉你“我在哪个分支”$git_statusGit 工作区状态符号如未提交修改、落后/超前等告诉你“工作区干不干净”$character❯/✗提示符字符命令输入起始标记其余 Starship 内置模块username、hostname、time、os、各种语言运行时版本号、cmd_duration、电池等在出厂配置中一律没有开启。这样渲染出的提示符几乎不占宽度、不带多余的感叹信息把认知负担降到最低。如果你需要更多信息或样式原文档也明确给出了入口修改~/.config/starship.toml并且特别强调“不要过度当然也可以过度这是你自己的电脑”。出厂配置的落地路径从仓库到你的$HOME要理解这份配置在系统中的位置需要先看懂 Omarchy 的配置分发机制详见 docs/file-layout.md仓库源文件config/starship.toml。打包分发该文件随omarchy-settings包安装到/etc/skel/.config/starship.toml同时保留一份拷贝在/usr/share/omarchy/config/starship.toml作为重置来源resync source。播种到用户/etc/skel仅在useradd -m创建新用户时被复制进$HOME因此新用户的默认配置文件即为~/.config/starship.toml。Starship 依赖starship本体被列入基础安装包清单 install/omarchy-base.packages随系统预装。Shell 初始化在 Bash 的初始化脚本 default/bash/init 中完成starship init bashif [[ $- *i* ]] [[ ${TERM:-} ! dumb ]] command -v starship /dev/null; then eval $(starship init bash) fi这段守卫条件值得注意仅当当前 Shell 是交互式$-含i、终端不是dumb避免污染非交互/脚本场景的输出、且starship命令确实可用时才初始化提示符。非交互脚本、管道等场景不会引入 Starship 的转义序列开销。另外Omarchy 面向 AI Agent 的配置速查文档 default/agents/skills/omarchy/SKILL.md 也把starship的配置位置登记为~/.config/starship.toml与上述分发路径保持一致。默认配置文件逐项拆解下面是仓库中 config/starship.toml 的完整内容我们对每一段做逐一说明add_newline true command_timeout 200 format $directory$git_branch$git_status$character [character] error_symbol ✗ success_symbol ❯ [directory] truncation_length 2 truncation_symbol …/ repo_root_style bold cyan repo_root_format $repo_root$path$read_only [git_branch] format $branch style italic cyan [git_status] format $all_status style cyan ahead ⇡${count} diverged ⇕⇡${ahead_count}⇣${behind_count} behind ⇣${count} conflicted up_to_date untracked ? modified stashed staged renamed deleted 全局顶层参数参数出厂值含义add_newlinetrue每次渲染 prompt 前先输出一个空行让每一条命令的输入区域与上一条命令的输出分隔开长输出后不会紧贴提示符command_timeout200单个模块为获取信息而执行外部命令如git status、目录探测等的最大等待毫秒数超时则该模块按失败处理避免 Git 仓库过大时 prompt 卡顿format$directory$git_branch$git_status$character顶层渲染模板决定模块出现顺序与整体布局方括号内为分组内容配色上整组directory git_branch git_status统一使用cyan色系粗体/斜体叠加视觉上形成“一行青色信息 一个青色❯”的低干扰风格。需要特别说明的是在仓库的default/themed/主题模板目录中没有starship 对应的.tpl模板因此这份 prompt 配置是静态出厂默认并不随 Omarchy 的主题系统动态改写颜色——主题变化影响的是终端本身foot/kitty/ghostty/alacritty 等而 prompt 自身保持这一套青色方案。[character]提示符字符character是每行 prompt 末尾、真正接受你输入的那个符号出厂配置为[character] error_symbol ✗ success_symbol ❯success_symbol上一条命令退出码为 0 时显示的字符这里是❯error_symbol上一条命令失败退出码非 0时显示的字符这里是✗两者都被强制指定为bold cyan——这意味着出错时 prompt 不会变成刺眼的红色而是保持与整体一致的青色系。对习惯了“红叉报错”的人来说这是一种风格化取舍它依然通过符号本身传达状态但不会破坏终端配色的整体观感。[directory]当前目录[directory] truncation_length 2 truncation_symbol …/ repo_root_style bold cyan repo_root_format $repo_root$path$read_only truncation_length 2路径过长时只保留最后两级目录如/home/omarchy/work/projects/omarchy会被压缩显示truncation_symbol …/截断部分用…/表示提示“前面还有被省略的层级”repo_root_style bold cyan在 Git 仓库内时仓库根目录部分以粗体青色突出显示repo_root_format自定义“仓库根 子路径”的拼接模板依次输出仓库根、剩余路径、只读标记read_only并以一个空格收尾让目录与后续模块Git 分支之间有自然的间隔。[git_branch]当前分支[git_branch] format $branch style italic cyan仅在位于 Git 仓库内时渲染显示当前分支名样式为斜体青色分支名后带一个空格用于分隔其后的 git 状态模块。[git_status]Git 工作区状态[git_status] format $all_status style cyan ahead ⇡${count} diverged ⇕⇡${ahead_count}⇣${behind_count} behind ⇣${count} conflicted up_to_date untracked ? modified stashed staged renamed deleted git_status用一个聚合的$all_status输出当前工作区状态默认只在“有值得提醒的变化”时给出符号。这里有一个刻意的设计符号为空字符串的状态conflicted、up_to_date、modified、stashed、staged、renamed、deleted表示完全不渲染对应内容。这正是“极简”在 Git 维度的体现——工作区干干净净时不输出任何噪音只有出现下面这些“异常”时才提示状态符号含义ahead⇡N本地领先远端 N 个提交尚未推送behind⇣N本地落后远端 N 个提交可以拉取diverged⇕⇡a⇣b本地与远端已分叉领先 a 个、落后 b 个untracked?存在尚未纳入 Git 跟踪的文件换言之默认提示符只在你需要“注意”时才出声有未推送提交、需要拉取、发生分叉或有未跟踪文件。而普通的修改/暂存等日常状态刻意静默避免每条命令后都堆满符号。自定义你的提示符原文档把自定义的入口、方式和边界说得非常清楚这里展开为可操作步骤。编辑位置直接编辑用户配置即可# 查看当前配置 cat ~/.config/starship.toml # 用任意编辑器修改 nano ~/.config/starship.toml # 或你习惯的编辑器 hx ~/.config/starship.tomlStarship 在每次渲染 prompt 时读取该文件保存后新开的终端窗口/新的 Shell 会话立即生效无需重启或重新登录。若想验证配置语法是否合法可运行starship explain交互式解释当前 prompt 各段来源或临时执行starship config查看解析结果。想加信息按需开启模块默认的克制并不妨碍你按需打开更多模块。比如想找回“用户与机器”信息、想看到上一条命令耗时或某个语言运行时版本可以在~/.config/starship.toml中追加对应模块段例如# 显示 用户名主机名仅在远程/普通用户下 [username] show_always false style_user bold cyan [hostname] ssh_only true # 显示命令耗时超过阈值才显示 [cmd_duration] min_time 2_000 style cyan # 显示 Rust 运行时版本 [rust] format $symbol($version )每个模块都有format、style、开关与阈值类参数官方文档Starship Presets 与每个模块的配置页提供了大量现成方案。原文档的忠告仍然适用想多花哨都可以只要别让它重新变得吵闹即可。Omarchy 的手册作者建议保持其原本的克制但选择权始终在你——正如原文档所说“its your computer”。恢复出厂默认~/.config/starship.toml由/etc/skel在用户创建时播种一次此后不会再被自动改写。若你把配置改乱了想回到出厂状态有两条路手动恢复用仓库中的出厂模板覆盖用户配置先备份再覆盖cp ~/.config/starship.toml ~/.config/starship.toml.bak cp /usr/share/omarchy/config/starship.toml ~/.config/starship.toml/usr/share/omarchy/config/starship.toml正是 docs/file-layout.md 中记录的 resync 源。整体重置运行 Omarchy 的显式重置命令omarchy-reinstall-configs对应 docs/file-layout.md 的“Explicit resync”章节它会将/etc/skel全量回放到$HOME。该命令是破坏性的凡是被/etc/skel覆盖的用户文件都会无备份地恢复成出厂默认因此如果你对starship.toml做过重要定制应先备份。另外从升级路径看仓库中处理既有用户升级的脚本 bin/omarchy-upgrade-to-quattro 将starship.toml与 foot、kitty、tmux、lazygit 等一批出厂配置一起纳入了基于文件哈希的refresh清单。从脚本结构可以推断这类清单用于在系统升级时精确刷新“仍与出厂版本一致”的配置文件——如果你从未改动过默认 prompt升级可能帮你带出厂配置的新默认而一旦你本地做过定制哈希不再匹配你的版本会被保留。也就是说默认 prompt 的演进会被 Omarchy 的版本迁移机制受控管理而不是每次升级都无脑覆盖你的自定义。小结Omarchy 的默认 prompt 由 Starship 驱动出厂只显示目录、Git 分支、Git 状态与一个❯字符刻意省略用户名与时间时间在顶栏——这是“信息各归其位”的极简设计。出厂配置位于 config/starship.toml安装后被播种为~/.config/starship.toml其中目录截断…/、青色系状态符号、Git 状态“非必要不显示”的取舍都可以直接阅读源码逐项确认。自定义只需编辑~/.config/starship.toml新 Shell 即时生效需要恢复出厂时可从/usr/share/omarchy/config/starship.toml手动覆盖或使用破坏性的omarchy-reinstall-configs整体重置。Starship 的能力上限远高于默认配置所展示的——官方文档、Presets 以及上述“按需开启模块”的示例都是你在“极简”与“功能丰富”之间自由发挥的起点。【免费下载链接】omarchyBeautiful, Modern Opinionated Linux项目地址: https://gitcode.com/GitHub_Trending/om/omarchy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考