Starship Catppuccin Powerline 预设完整指南安装、逐行拆解与四款配色切换【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本文以 Starship 仓库中的官方预设Catppuccin Powerline预设文档及其多语言副本如 docs/it-IT/presets/catppuccin-powerline.md为主体讲解这条“Powerline 风格 Catppuccin 调色板”提示符的安装方法、完整 TOML 的每一行含义以及如何在 Mocha / Frappe / Macchiato / Latte 四种 Catppuccin 风味之间切换。读完本文你既可以一键启用该预设也具备逐项微调配色、图标与模块行为的实战能力。一、预设概览Gruvbox Rainbow 的“换色版”Catppuccin Powerline 是 Starship 官方预设合集见 docs/presets/README.md中的一员。按照官方预设文档的描述它是Gruvbox Rainbow预设docs/presets/gruvbox-rainbow.md的“最小化修改版本”——布局与模块组织方式完全沿袭 Gruvbox Rainbow仅将配色整体替换为开源社区广受欢迎的 Catppuccin 主题调色板。从布局上看这是一条典型的Powerline 风格单行提示符使用$format顶层字段把os、username、directory、git_branch、git_status、一组语言运行时模块、conda、time、cmd_duration、character等模块首尾相连相邻模块背景色依次为red → peach → yellow → green → sapphire → lavender段与段之间用 Powerline 箭头字形Nerd Font 提供做平滑过渡line_break被显式禁用提示符尽量保持紧凑。二、前置条件安装并启用 Nerd Font预设文档明确列出的唯一硬性前置条件需要一个已安装并在终端中启用的 Nerd Font。原因可以从这份预设的 TOML 里直观看出——其中大量使用 Nerd Font 专属字形Powerline 分段箭头与圆角端帽字形/、/、/等分别在格式串的段与段之间、首尾处操作系统图标Windows 、Ubuntu 、Arch 、macOS 等 17 个[os.symbols]条目编程语言图标Rust 、Go 、Node.js 、Python 等路径图标与通用符号时间 、命令耗时 等。如果终端没有启用 Nerd Font这些字形会显示为方块豆腐块。安装 Nerd Font 后记得在你的终端模拟器设置中选择该字体作为显示字体再重新加载终端使配置生效。三、安装一行命令启用预设官方预设文档给出的安装命令如下starship preset catppuccin-powerline -o ~/.config/starship.toml这条命令把 Catppuccin Powerline 预设写入默认配置文件~/.config/starship.toml若你设置了STARSHIP_CONFIG环境变量指向其他路径则写入该路径对应的文件。之后打开新的终端窗口即可看到新提示符生效。starship preset子命令还支持其他几种用法便于预览与精细控制CLI 定义见 src/main.rs命令示例行为starship preset catppuccin-powerline不写文件直接把预设内容打印到标准输出适合先预览再决定是否应用starship preset catppuccin-powerline -o ~/.config/starship.toml写入指定文件-o/--output与--list互斥starship preset catppuccin-powerline -o out.toml -f-f/--force强制覆盖已存在的目标文件该选项依赖--output同时出现starship preset --list列出当前版本内置的所有预设名称例如其中的catppuccin-powerline其底层实现在 src/print.rspreset_command从编译期内嵌的预设内容中取出对应的 TOMLshadow::get_preset_content若指定了--output则通过utils::write_file_atomic原子写入目标文件否则原样输出到 stdout。相关单元测试如 src/print.rs 测试区中的preset_command_output_to_file还会直接与docs/public/presets/toml/下的源文件比对内容也就是说你从命令获得的预设内容与本仓库中 docs/public/presets/toml/catppuccin-powerline.toml 的官方源文件完全一致也可以在页面上直接下载该 TOML 后手动放到配置路径。四、完整预设 TOML 与总体结构以下是该预设的官方完整内容来源docs/public/presets/toml/catppuccin-powerline.toml$schema https://starship.rs/config-schema.json format \ $os\ $username\ \ $directory\ \ $git_branch\ $git_status\ \ $c\ $rust\ $golang\ $nodejs\ $bun\ $php\ $java\ $kotlin\ $haskell\ $python\ \ $conda\ \ $time\ \ $cmd_duration\ $line_break\ $character palette catppuccin_mocha [os] disabled false style bg:red fg:crust [os.symbols] Windows Ubuntu SUSE Raspbian Mint Macos Manjaro Linux Gentoo Fedora Alpine Amazon Android AOSC Arch Artix CentOS Debian Redhat RedHatEnterprise [username] show_always true style_user bg:red fg:crust style_root bg:red fg:crust format $user [directory] style bg:peach fg:crust format $path truncation_length 3 truncation_symbol …/ [directory.substitutions] Documents Downloads Music Pictures Developer [git_branch] symbol style bg:yellow format [ $symbol $branch ]($style) [git_status] style bg:yellow format [($all_status$ahead_behind )]($style) [nodejs] symbol style bg:green format [ $symbol( $version) ]($style) [bun] symbol style bg:green format [ $symbol( $version) ]($style) [c] symbol style bg:green format [ $symbol( $version) ]($style) [rust] symbol style bg:green format [ $symbol( $version) ]($style) [golang] symbol style bg:green format [ $symbol( $version) ]($style) [php] symbol style bg:green format [ $symbol( $version) ]($style) [java] symbol style bg:green format [ $symbol( $version) ]($style) [jj_bookmark] symbol style bg:yellow format [ $symbol $bookmark($remote)$diverged( \($overflow_count others\)) ]($style) [kotlin] symbol style bg:green format [ $symbol( $version) ]($style) [haskell] symbol style bg:green format [ $symbol( $version) ]($style) [python] symbol style bg:green format [ $symbol( $version)(\($virtualenv\)) ]($style) [docker_context] symbol style bg:sapphire format [ $symbol( $context) ]($style) [conda] symbol style fg:crust bg:sapphire format $symbol$environment ignore_base false [time] disabled false time_format %R style bg:lavender format [ $time ]($style) [line_break] disabled true [character] disabled false success_symbol ❯ error_symbol ❯ vimcmd_symbol ❮ vimcmd_replace_one_symbol ❮ vimcmd_replace_symbol ❮ vimcmd_visual_symbol ❮ [cmd_duration] show_milliseconds true format in $duration style bg:lavender disabled false show_notifications true min_time_to_notify 45000 [palettes.catppuccin_mocha] rosewater #f5e0dc flamingo #f2cdcd pink #f5c2e7 mauve #cba6f7 red #f38ba8 maroon #eba0ac peach #fab387 yellow #f9e2af green #a6e3a1 teal #94e2d5 sky #89dceb sapphire #74c7ec blue #89b4fa lavender #b4befe text #cdd6f4 subtext1 #bac2de subtext0 #a6adc8 overlay2 #9399b2 overlay1 #7f849c overlay0 #6c7086 surface2 #585b70 surface1 #45475a surface0 #313244 base #1e1e2e mantle #181825 crust #11111b [palettes.catppuccin_frappe] rosewater #f2d5cf flamingo #eebebe pink #f4b8e4 mauve #ca9ee6 red #e78284 maroon #ea999c peach #ef9f76 yellow #e5c890 green #a6d189 teal #81c8be sky #99d1db sapphire #85c1dc blue #8caaee lavender #babbf1 text #c6d0f5 subtext1 #b5bfe2 subtext0 #a5adce overlay2 #949cbb overlay1 #838ba7 overlay0 #737994 surface2 #626880 surface1 #51576d surface0 #414559 base #303446 mantle #292c3c crust #232634 [palettes.catppuccin_latte] rosewater #dc8a78 flamingo #dd7878 pink #ea76cb mauve #8839ef red #d20f39 maroon #e64553 peach #fe640b yellow #df8e1d green #40a02b teal #179299 sky #04a5e5 sapphire #209fb5 blue #1e66f5 lavender #7287fd text #4c4f69 subtext1 #5c5f77 subtext0 #6c6f85 overlay2 #7c7f93 overlay1 #8c8fa1 overlay0 #9ca0b0 surface2 #acb0be surface1 #bcc0cc surface0 #ccd0da base #eff1f5 mantle #e6e9ef crust #dce0e8 [palettes.catppuccin_macchiato] rosewater #f4dbd6 flamingo #f0c6c6 pink #f5bde6 mauve #c6a0f6 red #ed8796 maroon #ee99a0 peach #f5a97f yellow #eed49f green #a6da95 teal #8bd5ca sky #91d7e3 sapphire #7dc4e4 blue #8aadf4 lavender #b7bdf8 text #cad3f5 subtext1 #b8c0e0 subtext0 #a5adcb overlay2 #939ab7 overlay1 #8087a2 overlay0 #6e738d surface2 #5b6078 surface1 #494d64 surface0 #363a4f base #24273a mantle #1e2030 crust #181926为便于排版上文已将原文件中的图标字形以空格占位展示实际文件请直接查看 docs/public/presets/toml/catppuccin-powerline.toml。整个文件可分为四大部分文件头$schema指向 Starship 的 JSON Schema本仓库的 schema 见 docs/public/config-schema.json让支持 TOML schema 的编辑器在编辑时提供校验与补全顶层format与palette定义整条提示符的模块排布和当前生效的调色板若干[模块]配置节逐个定制各模块的颜色、图标、格式与开关状态四个[palettes.catppuccin_*]配置节一次性内置 Mocha / Frappe / Latte / Macchiato 四套完整色板通过顶层palette键切换。五、核心机制一format与 Powerline 箭头过渡format是这条预设的骨架。Starship 的格式串语法中文本表示把“文本”以“样式”渲染样式里的fg:/bg:指定前景色与背景色颜色名既可以是内置名称也可以引用palettes中自定义的具名颜色。Catppuccin Powerline 正是利用这一点在每个模块之间插入一个前景色 上一段背景色、背景色 下一段背景色的箭头字形从而画出平滑的颜色渐变阶梯。按顺序拆解format片段含义背景色行首圆角端帽左端开口red$os操作系统图标/名称见[os]red$username用户名show_always truered箭头从 red 过渡到 peachpeach$directory当前路径peach箭头从 peach 过渡到 yellowyellow$git_branch$git_statusGit 分支与仓库状态yellow箭头从 yellow 过渡到 greengreen$c$rust$golang$nodejs$bun$php$java$kotlin$haskell$python语言运行时在检测到对应项目时显示green箭头从 green 过渡到 sapphiresapphire$condaConda 环境sapphire箭头从 sapphire 过渡到 lavenderlavender$time当前时间24 小时制%Rlavender行尾圆角端帽右端开口lavender 前景$cmd_duration上一条命令耗时lavender$line_break被禁用[line_break] disabled true—$character行首提示符❯随上一条命令成败变绿/变红—一个值得注意的细节语言区把$c、$rust、$golang、$nodejs、$bun、$php、$java、$kotlin、$haskell、$python依次排布在同一段 green 背景上Starship 会在“当前目录恰好是这类项目”时才渲染对应模块因此绿色区段长度会随工程类型伸缩这正是 Gruvbox Rainbow / Pastel Powerline 一系预设的动态魅力所在。六、核心机制二模块逐个拆解1.[os]区分操作系统的图标段[os] disabled false style bg:red fg:crust[os]默认是关闭的这里显式disabled false打开把系统名渲染在 red 背景的提示符最左端。[os.symbols]表列出了从 Windows、Ubuntu、Arch、SUSE、Raspbian、Mint、macOS、Manjaro、Linux、Gentoo、Fedora、Alpine、Amazon、Android、AOSC、Artix、CentOS、Debian、Redhat 到 RedHatEnterprise 的 17 类系统/发行版图标style中的fg:crust让图标使用调色板中最深的“外壳色”Mocha 下为#11111b保证与 red 背景形成对比。该模块的实际系统探测与图标映射逻辑可对照源码目录 src/configs/os.rs 与 src/modules/os.rs 阅读。2.[username]总是显示的用户名[username] show_always true style_user bg:red fg:crust style_root bg:red fg:crust format $userStarship 默认只有在登录用户与当前用户不一致、或通过 SSH 连接时才显示用户名show_always true则无条件显示。style_user与style_root分别覆盖普通用户与 root 用户的样式这里保持一致保证用户名与前一节 os 一样处于 red 背景形成连续的红色头段。3.[directory]路径 图标替换[directory] style bg:peach fg:crust format $path truncation_length 3 truncation_symbol …/ [directory.substitutions] Documents Downloads Music Pictures Developer truncation_length 3只保留路径中最右侧的 3 层目录truncation_symbol …/被截断的左侧部分用省略号代替[directory.substitutions]把常见目录名整体替换为带空格的图标字形Documents/Downloads/Music/Pictures/Developer让路径更紧凑直观。路径替换与截断的详细规则可继续查阅 docs/config/README.md 中directory一节以及源码 src/modules/directory.rs。4. Git 双模块[git_branch]与[git_status][git_branch] symbol style bg:yellow format [ $symbol $branch ]($style) [git_status] style bg:yellow format [($all_status$ahead_behind )]($style)两者共享 yellow 背景git_branch显示分支名外框花括号里套内层[...]是“先按样式渲染内层、再把结果按外层样式排版”的嵌套写法git_status使用$all_status未提交/未跟踪/冲突等所有状态缩写与$ahead_behind领先/落后远端提交数组合展示仓库工作区情况。配置中还额外出现了[jj_bookmark]Jujutsu 版本控制的 bookmark 模块样式与 git_branch 对齐说明该预设对 Jujutsu 用户同样友好。5. 语言运行时绿色“彩蛋”区C、Rust、Go、Node.js、Bun、PHP、Java、Kotlin、Haskell、Python 均使用近乎一致的四行模板[python] symbol style bg:green format [ $symbol( $version)(\($virtualenv\)) ]($style)symbol各语言对应的 Nerd Font 图标format中的( $version)在版本号存在时才输出Python 额外带(\($virtualenv\))激活虚拟环境时追加环境名bun则对应 Bun 运行时。若把$version显式移除即可得到与 no-runtime-versions 预设 类似“只显示语言不显示版本”的效果——这也是手动裁剪这条预设时最常用的入门改动。6. 容器与环境[docker_context]、[conda][docker_context] symbol style bg:sapphire format [ $symbol( $context) ]($style) [conda] symbol style fg:crust bg:sapphire format $symbol$environment ignore_base falsedocker_context在有 Docker 上下文且非默认时显示图标与上下文名conda在 sapphire 背景上显示当前 conda 环境且ignore_base false意味着即使处于base环境也会显示默认行为是忽略 base。7. 时间与耗时[time]、[cmd_duration][time] disabled false time_format %R style bg:lavender format [ $time ]($style) [cmd_duration] show_milliseconds true format in $duration style bg:lavender disabled false show_notifications true min_time_to_notify 45000time模块默认关闭这里显式开启%R表示 24 小时制如23:59放在 lavender 段内cmd_duration默认即开启这里强化细节show_milliseconds true让耗时显示毫秒精度show_notifications true配合min_time_to_notify 45000在单条命令执行超过 45 秒时发送桌面通知。8.[character]随命令成败变色[character] disabled false success_symbol ❯ error_symbol ❯ vimcmd_symbol ❮ vimcmd_replace_one_symbol ❮ vimcmd_replace_symbol ❮ vimcmd_visual_symbol ❮character提供上一条命令退出码的即时视觉反馈成功为绿色❯失败为红色❯在支持 Vi 模式的 shell 中进入命令模式/替换模式/可视模式时切换为不同颜色的❮据此可判断当前的按键模式。七、核心机制三在四种 Catppuccin 风味间切换预设文档特别说明默认使用 Catppuccin 的 Mocha 风味。想换成其他风味只需要修改顶层palette键文件内已内置全部四个可选值palette取值Catppuccin 风味对应 [palettes] 配置节底色倾向catppuccin_mocha默认Mocha[palettes.catppuccin_mocha]深紫黑底base#1e1e2ecatppuccin_frappeFrappé[palettes.catppuccin_frappe]灰蓝深底base#303446catppuccin_macchiatoMacchiato[palettes.catppuccin_macchiato]深蓝紫底base#24273acatppuccin_latteLatte[palettes.catppuccin_latte]浅色底base#eff1f5例如切换为浅色风味的 Lattepalette catppuccin_latte保存后重载 shell 即可看到整条提示符全部换色。能做到“只改一个键就全局换肤”正是因为format和各模块样式中只使用具名颜色red、peach、yellow、green、sapphire、lavender、crust、base等而不是写死的十六进制值这些名字在四个[palettes.catppuccin_*]节中分别定义palette ...决定当前解析哪一组。因此你甚至可以继续叠加自定义色板例如把某两个名称微调成你偏好的色值只要[palettes.name]存在并能被顶层palette引用即可。八、四套调色板全量色值对照下表将本预设内置的 26 个具名颜色在四种风味下的色值并列展示数据均取自 docs/public/presets/toml/catppuccin-powerline.toml方便按需微调颜色名MochaFrappéMacchiatoLatterosewater#f5e0dc#f2d5cf#f4dbd6#dc8a78flamingo#f2cdcd#eebebe#f0c6c6#dd7878pink#f5c2e7#f4b8e4#f5bde6#ea76cbmauve#cba6f7#ca9ee6#c6a0f6#8839efred#f38ba8#e78284#ed8796#d20f39maroon#eba0ac#ea999c#ee99a0#e64553peach#fab387#ef9f76#f5a97f#fe640byellow#f9e2af#e5c890#eed49f#df8e1dgreen#a6e3a1#a6d189#a6da95#40a02bteal#94e2d5#81c8be#8bd5ca#179299sky#89dceb#99d1db#91d7e3#04a5e5sapphire#74c7ec#85c1dc#7dc4e4#209fb5blue#89b4fa#8caaee#8aadf4#1e66f5lavender#b4befe#babbf1#b7bdf8#7287fdtext#cdd6f4#c6d0f5#cad3f5#4c4f69subtext1#bac2de#b5bfe2#b8c0e0#5c5f77subtext0#a6adc8#a5adce#a5adcb#6c6f85overlay2#9399b2#949cbb#939ab7#7c7f93overlay1#7f849c#838ba7#8087a2#8c8fa1overlay0#6c7086#737994#6e738d#9ca0b0surface2#585b70#626880#5b6078#acb0besurface1#45475a#51576d#494d64#bcc0ccsurface0#313244#414559#363a4f#ccd0dabase#1e1e2e#303446#24273a#eff1f5mantle#181825#292c3c#1e2030#e6e9efcrust#11111b#232634#181926#dce0e8可以看到本预设各模块的底色red/peach/yellow/green/sapphire/lavender与文字色crust在不同风味下都被替换为对应语义的色值因此切换风味时段落对比度与“分层感”始终一致——即便 Latte 是浅色系crust也被取为较浅的#dce0e8以保证图标文字在高饱和背景上可读。九、常见自定义与提示基于上述源码级理解你可以用很小的改动得到“自己的 Catppuccin Powerline”换风味把顶层palette catppuccin_mocha换成四个catppuccin_*值之一去掉版本号删除某语言模块format中的( $version)片段让绿色区段只显示语言图标加长路径保留层数调大directory.truncation_length或改truncation_symbol为⋯/之类的自定义省略符修改系统图标映射在[os.symbols]中覆盖对应键或为你的发行版新增条目需与 src/modules/os.rs 支持的探测结果对应微调某一背景色直接改动[palettes.catppuccin_*]中对应名称的十六进制值所有引用该名称的模块会同步更新备份与回滚应用预设前先cp ~/.config/starship.toml ~/.config/starship.toml.bak或在改坏后重新执行starship preset catppuccin-powerline -o ~/.config/starship.toml -f一键还原为官方配置。如果只想快速验证效果而不想动正式配置可以先执行不带-o的starship preset catppuccin-powerline预览输出再决定是否落盘需要确认当前版本包含哪些预设时用starship preset --list查看清单。关于 Starship 全局配置项、各模块默认值的完整参考可继续阅读 docs/config/README.md更多同风格预设如 Pastel Powerline、Gruvbox Rainbow、Tokyo Night见 docs/presets/README.md。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/9 12:57:58 · 阅读 1.2k Starship Catppuccin Powerline 预设完整指南：安装、逐行拆解与四款配色切换
Starship Catppuccin Powerline 预设完整指南安装、逐行拆解与四款配色切换【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本文以 Starship 仓库中的官方预设Catppuccin Powerline预设文档及其多语言副本如 docs/it-IT/presets/catppuccin-powerline.md为主体讲解这条“Powerline 风格 Catppuccin 调色板”提示符的安装方法、完整 TOML 的每一行含义以及如何在 Mocha / Frappe / Macchiato / Latte 四种 Catppuccin 风味之间切换。读完本文你既可以一键启用该预设也具备逐项微调配色、图标与模块行为的实战能力。一、预设概览Gruvbox Rainbow 的“换色版”Catppuccin Powerline 是 Starship 官方预设合集见 docs/presets/README.md中的一员。按照官方预设文档的描述它是Gruvbox Rainbow预设docs/presets/gruvbox-rainbow.md的“最小化修改版本”——布局与模块组织方式完全沿袭 Gruvbox Rainbow仅将配色整体替换为开源社区广受欢迎的 Catppuccin 主题调色板。从布局上看这是一条典型的Powerline 风格单行提示符使用$format顶层字段把os、username、directory、git_branch、git_status、一组语言运行时模块、conda、time、cmd_duration、character等模块首尾相连相邻模块背景色依次为red → peach → yellow → green → sapphire → lavender段与段之间用 Powerline 箭头字形Nerd Font 提供做平滑过渡line_break被显式禁用提示符尽量保持紧凑。二、前置条件安装并启用 Nerd Font预设文档明确列出的唯一硬性前置条件需要一个已安装并在终端中启用的 Nerd Font。原因可以从这份预设的 TOML 里直观看出——其中大量使用 Nerd Font 专属字形Powerline 分段箭头与圆角端帽字形/、/、/等分别在格式串的段与段之间、首尾处操作系统图标Windows 、Ubuntu 、Arch 、macOS 等 17 个[os.symbols]条目编程语言图标Rust 、Go 、Node.js 、Python 等路径图标与通用符号时间 、命令耗时 等。如果终端没有启用 Nerd Font这些字形会显示为方块豆腐块。安装 Nerd Font 后记得在你的终端模拟器设置中选择该字体作为显示字体再重新加载终端使配置生效。三、安装一行命令启用预设官方预设文档给出的安装命令如下starship preset catppuccin-powerline -o ~/.config/starship.toml这条命令把 Catppuccin Powerline 预设写入默认配置文件~/.config/starship.toml若你设置了STARSHIP_CONFIG环境变量指向其他路径则写入该路径对应的文件。之后打开新的终端窗口即可看到新提示符生效。starship preset子命令还支持其他几种用法便于预览与精细控制CLI 定义见 src/main.rs命令示例行为starship preset catppuccin-powerline不写文件直接把预设内容打印到标准输出适合先预览再决定是否应用starship preset catppuccin-powerline -o ~/.config/starship.toml写入指定文件-o/--output与--list互斥starship preset catppuccin-powerline -o out.toml -f-f/--force强制覆盖已存在的目标文件该选项依赖--output同时出现starship preset --list列出当前版本内置的所有预设名称例如其中的catppuccin-powerline其底层实现在 src/print.rspreset_command从编译期内嵌的预设内容中取出对应的 TOMLshadow::get_preset_content若指定了--output则通过utils::write_file_atomic原子写入目标文件否则原样输出到 stdout。相关单元测试如 src/print.rs 测试区中的preset_command_output_to_file还会直接与docs/public/presets/toml/下的源文件比对内容也就是说你从命令获得的预设内容与本仓库中 docs/public/presets/toml/catppuccin-powerline.toml 的官方源文件完全一致也可以在页面上直接下载该 TOML 后手动放到配置路径。四、完整预设 TOML 与总体结构以下是该预设的官方完整内容来源docs/public/presets/toml/catppuccin-powerline.toml$schema https://starship.rs/config-schema.json format \ $os\ $username\ \ $directory\ \ $git_branch\ $git_status\ \ $c\ $rust\ $golang\ $nodejs\ $bun\ $php\ $java\ $kotlin\ $haskell\ $python\ \ $conda\ \ $time\ \ $cmd_duration\ $line_break\ $character palette catppuccin_mocha [os] disabled false style bg:red fg:crust [os.symbols] Windows Ubuntu SUSE Raspbian Mint Macos Manjaro Linux Gentoo Fedora Alpine Amazon Android AOSC Arch Artix CentOS Debian Redhat RedHatEnterprise [username] show_always true style_user bg:red fg:crust style_root bg:red fg:crust format $user [directory] style bg:peach fg:crust format $path truncation_length 3 truncation_symbol …/ [directory.substitutions] Documents Downloads Music Pictures Developer [git_branch] symbol style bg:yellow format [ $symbol $branch ]($style) [git_status] style bg:yellow format [($all_status$ahead_behind )]($style) [nodejs] symbol style bg:green format [ $symbol( $version) ]($style) [bun] symbol style bg:green format [ $symbol( $version) ]($style) [c] symbol style bg:green format [ $symbol( $version) ]($style) [rust] symbol style bg:green format [ $symbol( $version) ]($style) [golang] symbol style bg:green format [ $symbol( $version) ]($style) [php] symbol style bg:green format [ $symbol( $version) ]($style) [java] symbol style bg:green format [ $symbol( $version) ]($style) [jj_bookmark] symbol style bg:yellow format [ $symbol $bookmark($remote)$diverged( \($overflow_count others\)) ]($style) [kotlin] symbol style bg:green format [ $symbol( $version) ]($style) [haskell] symbol style bg:green format [ $symbol( $version) ]($style) [python] symbol style bg:green format [ $symbol( $version)(\($virtualenv\)) ]($style) [docker_context] symbol style bg:sapphire format [ $symbol( $context) ]($style) [conda] symbol style fg:crust bg:sapphire format $symbol$environment ignore_base false [time] disabled false time_format %R style bg:lavender format [ $time ]($style) [line_break] disabled true [character] disabled false success_symbol ❯ error_symbol ❯ vimcmd_symbol ❮ vimcmd_replace_one_symbol ❮ vimcmd_replace_symbol ❮ vimcmd_visual_symbol ❮ [cmd_duration] show_milliseconds true format in $duration style bg:lavender disabled false show_notifications true min_time_to_notify 45000 [palettes.catppuccin_mocha] rosewater #f5e0dc flamingo #f2cdcd pink #f5c2e7 mauve #cba6f7 red #f38ba8 maroon #eba0ac peach #fab387 yellow #f9e2af green #a6e3a1 teal #94e2d5 sky #89dceb sapphire #74c7ec blue #89b4fa lavender #b4befe text #cdd6f4 subtext1 #bac2de subtext0 #a6adc8 overlay2 #9399b2 overlay1 #7f849c overlay0 #6c7086 surface2 #585b70 surface1 #45475a surface0 #313244 base #1e1e2e mantle #181825 crust #11111b [palettes.catppuccin_frappe] rosewater #f2d5cf flamingo #eebebe pink #f4b8e4 mauve #ca9ee6 red #e78284 maroon #ea999c peach #ef9f76 yellow #e5c890 green #a6d189 teal #81c8be sky #99d1db sapphire #85c1dc blue #8caaee lavender #babbf1 text #c6d0f5 subtext1 #b5bfe2 subtext0 #a5adce overlay2 #949cbb overlay1 #838ba7 overlay0 #737994 surface2 #626880 surface1 #51576d surface0 #414559 base #303446 mantle #292c3c crust #232634 [palettes.catppuccin_latte] rosewater #dc8a78 flamingo #dd7878 pink #ea76cb mauve #8839ef red #d20f39 maroon #e64553 peach #fe640b yellow #df8e1d green #40a02b teal #179299 sky #04a5e5 sapphire #209fb5 blue #1e66f5 lavender #7287fd text #4c4f69 subtext1 #5c5f77 subtext0 #6c6f85 overlay2 #7c7f93 overlay1 #8c8fa1 overlay0 #9ca0b0 surface2 #acb0be surface1 #bcc0cc surface0 #ccd0da base #eff1f5 mantle #e6e9ef crust #dce0e8 [palettes.catppuccin_macchiato] rosewater #f4dbd6 flamingo #f0c6c6 pink #f5bde6 mauve #c6a0f6 red #ed8796 maroon #ee99a0 peach #f5a97f yellow #eed49f green #a6da95 teal #8bd5ca sky #91d7e3 sapphire #7dc4e4 blue #8aadf4 lavender #b7bdf8 text #cad3f5 subtext1 #b8c0e0 subtext0 #a5adcb overlay2 #939ab7 overlay1 #8087a2 overlay0 #6e738d surface2 #5b6078 surface1 #494d64 surface0 #363a4f base #24273a mantle #1e2030 crust #181926为便于排版上文已将原文件中的图标字形以空格占位展示实际文件请直接查看 docs/public/presets/toml/catppuccin-powerline.toml。整个文件可分为四大部分文件头$schema指向 Starship 的 JSON Schema本仓库的 schema 见 docs/public/config-schema.json让支持 TOML schema 的编辑器在编辑时提供校验与补全顶层format与palette定义整条提示符的模块排布和当前生效的调色板若干[模块]配置节逐个定制各模块的颜色、图标、格式与开关状态四个[palettes.catppuccin_*]配置节一次性内置 Mocha / Frappe / Latte / Macchiato 四套完整色板通过顶层palette键切换。五、核心机制一format与 Powerline 箭头过渡format是这条预设的骨架。Starship 的格式串语法中文本表示把“文本”以“样式”渲染样式里的fg:/bg:指定前景色与背景色颜色名既可以是内置名称也可以引用palettes中自定义的具名颜色。Catppuccin Powerline 正是利用这一点在每个模块之间插入一个前景色 上一段背景色、背景色 下一段背景色的箭头字形从而画出平滑的颜色渐变阶梯。按顺序拆解format片段含义背景色行首圆角端帽左端开口red$os操作系统图标/名称见[os]red$username用户名show_always truered箭头从 red 过渡到 peachpeach$directory当前路径peach箭头从 peach 过渡到 yellowyellow$git_branch$git_statusGit 分支与仓库状态yellow箭头从 yellow 过渡到 greengreen$c$rust$golang$nodejs$bun$php$java$kotlin$haskell$python语言运行时在检测到对应项目时显示green箭头从 green 过渡到 sapphiresapphire$condaConda 环境sapphire箭头从 sapphire 过渡到 lavenderlavender$time当前时间24 小时制%Rlavender行尾圆角端帽右端开口lavender 前景$cmd_duration上一条命令耗时lavender$line_break被禁用[line_break] disabled true—$character行首提示符❯随上一条命令成败变绿/变红—一个值得注意的细节语言区把$c、$rust、$golang、$nodejs、$bun、$php、$java、$kotlin、$haskell、$python依次排布在同一段 green 背景上Starship 会在“当前目录恰好是这类项目”时才渲染对应模块因此绿色区段长度会随工程类型伸缩这正是 Gruvbox Rainbow / Pastel Powerline 一系预设的动态魅力所在。六、核心机制二模块逐个拆解1.[os]区分操作系统的图标段[os] disabled false style bg:red fg:crust[os]默认是关闭的这里显式disabled false打开把系统名渲染在 red 背景的提示符最左端。[os.symbols]表列出了从 Windows、Ubuntu、Arch、SUSE、Raspbian、Mint、macOS、Manjaro、Linux、Gentoo、Fedora、Alpine、Amazon、Android、AOSC、Artix、CentOS、Debian、Redhat 到 RedHatEnterprise 的 17 类系统/发行版图标style中的fg:crust让图标使用调色板中最深的“外壳色”Mocha 下为#11111b保证与 red 背景形成对比。该模块的实际系统探测与图标映射逻辑可对照源码目录 src/configs/os.rs 与 src/modules/os.rs 阅读。2.[username]总是显示的用户名[username] show_always true style_user bg:red fg:crust style_root bg:red fg:crust format $userStarship 默认只有在登录用户与当前用户不一致、或通过 SSH 连接时才显示用户名show_always true则无条件显示。style_user与style_root分别覆盖普通用户与 root 用户的样式这里保持一致保证用户名与前一节 os 一样处于 red 背景形成连续的红色头段。3.[directory]路径 图标替换[directory] style bg:peach fg:crust format $path truncation_length 3 truncation_symbol …/ [directory.substitutions] Documents Downloads Music Pictures Developer truncation_length 3只保留路径中最右侧的 3 层目录truncation_symbol …/被截断的左侧部分用省略号代替[directory.substitutions]把常见目录名整体替换为带空格的图标字形Documents/Downloads/Music/Pictures/Developer让路径更紧凑直观。路径替换与截断的详细规则可继续查阅 docs/config/README.md 中directory一节以及源码 src/modules/directory.rs。4. Git 双模块[git_branch]与[git_status][git_branch] symbol style bg:yellow format [ $symbol $branch ]($style) [git_status] style bg:yellow format [($all_status$ahead_behind )]($style)两者共享 yellow 背景git_branch显示分支名外框花括号里套内层[...]是“先按样式渲染内层、再把结果按外层样式排版”的嵌套写法git_status使用$all_status未提交/未跟踪/冲突等所有状态缩写与$ahead_behind领先/落后远端提交数组合展示仓库工作区情况。配置中还额外出现了[jj_bookmark]Jujutsu 版本控制的 bookmark 模块样式与 git_branch 对齐说明该预设对 Jujutsu 用户同样友好。5. 语言运行时绿色“彩蛋”区C、Rust、Go、Node.js、Bun、PHP、Java、Kotlin、Haskell、Python 均使用近乎一致的四行模板[python] symbol style bg:green format [ $symbol( $version)(\($virtualenv\)) ]($style)symbol各语言对应的 Nerd Font 图标format中的( $version)在版本号存在时才输出Python 额外带(\($virtualenv\))激活虚拟环境时追加环境名bun则对应 Bun 运行时。若把$version显式移除即可得到与 no-runtime-versions 预设 类似“只显示语言不显示版本”的效果——这也是手动裁剪这条预设时最常用的入门改动。6. 容器与环境[docker_context]、[conda][docker_context] symbol style bg:sapphire format [ $symbol( $context) ]($style) [conda] symbol style fg:crust bg:sapphire format $symbol$environment ignore_base falsedocker_context在有 Docker 上下文且非默认时显示图标与上下文名conda在 sapphire 背景上显示当前 conda 环境且ignore_base false意味着即使处于base环境也会显示默认行为是忽略 base。7. 时间与耗时[time]、[cmd_duration][time] disabled false time_format %R style bg:lavender format [ $time ]($style) [cmd_duration] show_milliseconds true format in $duration style bg:lavender disabled false show_notifications true min_time_to_notify 45000time模块默认关闭这里显式开启%R表示 24 小时制如23:59放在 lavender 段内cmd_duration默认即开启这里强化细节show_milliseconds true让耗时显示毫秒精度show_notifications true配合min_time_to_notify 45000在单条命令执行超过 45 秒时发送桌面通知。8.[character]随命令成败变色[character] disabled false success_symbol ❯ error_symbol ❯ vimcmd_symbol ❮ vimcmd_replace_one_symbol ❮ vimcmd_replace_symbol ❮ vimcmd_visual_symbol ❮character提供上一条命令退出码的即时视觉反馈成功为绿色❯失败为红色❯在支持 Vi 模式的 shell 中进入命令模式/替换模式/可视模式时切换为不同颜色的❮据此可判断当前的按键模式。七、核心机制三在四种 Catppuccin 风味间切换预设文档特别说明默认使用 Catppuccin 的 Mocha 风味。想换成其他风味只需要修改顶层palette键文件内已内置全部四个可选值palette取值Catppuccin 风味对应 [palettes] 配置节底色倾向catppuccin_mocha默认Mocha[palettes.catppuccin_mocha]深紫黑底base#1e1e2ecatppuccin_frappeFrappé[palettes.catppuccin_frappe]灰蓝深底base#303446catppuccin_macchiatoMacchiato[palettes.catppuccin_macchiato]深蓝紫底base#24273acatppuccin_latteLatte[palettes.catppuccin_latte]浅色底base#eff1f5例如切换为浅色风味的 Lattepalette catppuccin_latte保存后重载 shell 即可看到整条提示符全部换色。能做到“只改一个键就全局换肤”正是因为format和各模块样式中只使用具名颜色red、peach、yellow、green、sapphire、lavender、crust、base等而不是写死的十六进制值这些名字在四个[palettes.catppuccin_*]节中分别定义palette ...决定当前解析哪一组。因此你甚至可以继续叠加自定义色板例如把某两个名称微调成你偏好的色值只要[palettes.name]存在并能被顶层palette引用即可。八、四套调色板全量色值对照下表将本预设内置的 26 个具名颜色在四种风味下的色值并列展示数据均取自 docs/public/presets/toml/catppuccin-powerline.toml方便按需微调颜色名MochaFrappéMacchiatoLatterosewater#f5e0dc#f2d5cf#f4dbd6#dc8a78flamingo#f2cdcd#eebebe#f0c6c6#dd7878pink#f5c2e7#f4b8e4#f5bde6#ea76cbmauve#cba6f7#ca9ee6#c6a0f6#8839efred#f38ba8#e78284#ed8796#d20f39maroon#eba0ac#ea999c#ee99a0#e64553peach#fab387#ef9f76#f5a97f#fe640byellow#f9e2af#e5c890#eed49f#df8e1dgreen#a6e3a1#a6d189#a6da95#40a02bteal#94e2d5#81c8be#8bd5ca#179299sky#89dceb#99d1db#91d7e3#04a5e5sapphire#74c7ec#85c1dc#7dc4e4#209fb5blue#89b4fa#8caaee#8aadf4#1e66f5lavender#b4befe#babbf1#b7bdf8#7287fdtext#cdd6f4#c6d0f5#cad3f5#4c4f69subtext1#bac2de#b5bfe2#b8c0e0#5c5f77subtext0#a6adc8#a5adce#a5adcb#6c6f85overlay2#9399b2#949cbb#939ab7#7c7f93overlay1#7f849c#838ba7#8087a2#8c8fa1overlay0#6c7086#737994#6e738d#9ca0b0surface2#585b70#626880#5b6078#acb0besurface1#45475a#51576d#494d64#bcc0ccsurface0#313244#414559#363a4f#ccd0dabase#1e1e2e#303446#24273a#eff1f5mantle#181825#292c3c#1e2030#e6e9efcrust#11111b#232634#181926#dce0e8可以看到本预设各模块的底色red/peach/yellow/green/sapphire/lavender与文字色crust在不同风味下都被替换为对应语义的色值因此切换风味时段落对比度与“分层感”始终一致——即便 Latte 是浅色系crust也被取为较浅的#dce0e8以保证图标文字在高饱和背景上可读。九、常见自定义与提示基于上述源码级理解你可以用很小的改动得到“自己的 Catppuccin Powerline”换风味把顶层palette catppuccin_mocha换成四个catppuccin_*值之一去掉版本号删除某语言模块format中的( $version)片段让绿色区段只显示语言图标加长路径保留层数调大directory.truncation_length或改truncation_symbol为⋯/之类的自定义省略符修改系统图标映射在[os.symbols]中覆盖对应键或为你的发行版新增条目需与 src/modules/os.rs 支持的探测结果对应微调某一背景色直接改动[palettes.catppuccin_*]中对应名称的十六进制值所有引用该名称的模块会同步更新备份与回滚应用预设前先cp ~/.config/starship.toml ~/.config/starship.toml.bak或在改坏后重新执行starship preset catppuccin-powerline -o ~/.config/starship.toml -f一键还原为官方配置。如果只想快速验证效果而不想动正式配置可以先执行不带-o的starship preset catppuccin-powerline预览输出再决定是否落盘需要确认当前版本包含哪些预设时用starship preset --list查看清单。关于 Starship 全局配置项、各模块默认值的完整参考可继续阅读 docs/config/README.md更多同风格预设如 Pastel Powerline、Gruvbox Rainbow、Tokyo Night见 docs/presets/README.md。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考