Starship Preset 预设完整指南12 个内置风格预设与 starship preset 命令的底层实现【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本文围绕 Starship 官方文档中的 Presets预设章节展开系统介绍仓库内置的 12 个社区贡献的配置预设它们各自改变提示符的哪些部分、适用什么场景、如何一键安装并结合src/main.rs与src/print.rs的源码说明starship preset命令的解析流程、预设 TOML 文件的存放位置与测试验证方式。读完后你可以为终端选择一套现成风格并具备基于预设二次定制~/.config/starship.toml的能力。一、什么是 Starship Preset如何安装Preset预设是 Starship 官方维护的一组社区提交的完整配置文件starship.toml格式。每个预设针对一类审美或环境诉求例如更换全部模块的图标符号、改用方括号分隔各模块、隐藏运行时版本号、复刻 Pure 提示符风格或实现 Powerline 风格的彩色分段。官方文档 docs/presets/README.md 提供了完整目录其阿拉伯语版本 docs/ar-SA/presets/README.md 内容一致。安装方式非常直接预设内容随二进制分发通过starship preset子命令输出。以官方文档给出的命令为例starship preset nerd-font-symbols -o ~/.config/starship.toml该命令的完整参数在 src/main.rs 中定义Preset子命令参数说明name位置参数要输出的预设名取值由print::Preset枚举限定当传入--list时可省略-o, --output PATH将预设写入文件而不是 stdout与--list互斥-f, --force目标文件已存在时强制覆盖必须与--output同时使用-l, --list列出所有可用预设名因此推荐的实操流程是starship preset --list # 查看当前版本内置的全部预设名 starship preset name -o ~/.config/starship.toml # 写入配置文件值得注意-f参数意味着覆盖现有配置是受控操作——不带--force时写入已存在的文件会报错实现见下文preset_command的write_file_atomic调用避免了误覆盖用户自定义配置。二、官方预设全目录12 个以下逐一覆盖官方文档列出的全部预设每个都附上文档页与 TOML 源文件可直接查看配置细节Nerd Font Symbols文档 / TOML 将所有模块的符号替换为 Nerd Font 图标。前提是在终端中安装并启用 Nerd Font官方示例使用 Fira Code Nerd Font。No Nerd Fonts文档 / TOML 将多个模块的符号改为非 Nerd Font 字符保证整个提示符不依赖 Nerd Font 渲染。官方文档提示该预设将在 Starship 的某个未来版本中成为默认预设。Bracketed Segments文档 / TOML 将所有内置模块的格式改为用方括号显示各自的分段替代默认的 Starship 措辞“via”、“on”等英文连接词。Plain Text Symbols文档 / TOML 将各模块符号替换为纯文本形式适合终端或环境不支持 Unicode 的场景。No Runtime Versions文档 / TOML 隐藏语言运行时的版本号。官方文档特别指出如果你常在容器或虚拟化环境中工作这个预设最合适。No Empty Icons文档 / TOML 当工具链toolset未被检测到时不显示其图标避免提示符中出现“空”模块。Pure Prompt文档 / TOML 模拟 Pure 提示符的外观与行为简洁、失败时才显示额外信息。Pastel Powerline文档 / TOML 受 oh-my-posh 的 M365Princess 主题启发的 Powerline 风格预设同时也是 Starship 中路径替换directory.substitutions机制的官方示例。Tokyo Night文档 / TOML 配色灵感来自 tokyo-night-vscode-theme 这一流行 VS Code 主题。Gruvbox Rainbow文档 / TOML 深受 Pastel Powerline 与 Tokyo Night 两个预设启发使用 Gruvbox 配色的 Powerline 分段。Jetpack文档 / TOML 受 geometry 与 spaceship 提示符启发的准极简预设。Catppuccin Powerline文档 / TOML 在 Gruvbox Rainbow 基础上做最小改动替换为 Catppuccin 主题调色板。每个预设都配有官方截图位于 docs/public/presets/img/ 目录例如 bracketed-segments.png、nerd-font-symbols.png、tokyo-night.png、catppuccin-powerline.png、jetpack.png 等可在文档站中对照选择风格。三、典型预设的配置解剖Nerd Font Symbols符号覆盖的完整清单TOML 源文件 展示了“纯符号覆盖型”预设的典型结构——不改变任何模块的format或style只重写各模块的symbol字段。它覆盖的模块包括aws、azure、battery含 full/charging/discharging/unknown/empty 五种状态符号、buf、bun、c、cpp、cmake、cobol、conda、container、crystal、dart、deno、direnv、directoryread_only符号、docker_context、dotnet、elixir、elm、erlang、fennel、fortran、fossil_branch、gcloud、gleam、git_branch、git_committag_symbol、golang、gradle、guix_shell、haskell、haxe、helm、hg_branch、hostnamessh_symbol、java、jj_bookmark、julia、kotlin、kubernetes、lua、maven、memory_usage、meson、mojo、nats、netns、nim、nix_shell、nodejs、ocaml、odin、opa、openstack、package、perl、php、pijul_channel、pixi、pulumi、purescript、python、raku、red、rlang、ruby、rust、scala、shlvl、singularity、solidity、spack、status、sudo、swift、terraform、vlang、typst、vagrant、xmake、zig。其中最特殊的是[os.symbols]表它按发行版名称逐一定义系统符号如Arch、Debian、Fedora、Macos、Windows、NixOS、Unknown等 60 余个键。这提示了一个定制技巧如果你只想换系统图标可以只摘取[os.symbols]这一段。文件首行为$schema https://starship.rs/config-schema.json指向官方 JSON Schema配合支持 schema 的编辑器可获得 TOML 配置补全与校验。Pastel PowerlinePowerline 分段、格式串与路径替换pastel-powerline.toml 是“结构性改造型”预设的代表它演示了三个高阶配置能力重写全局format控制模块顺序。预设顶部用一个多行format字符串显式编排各模块的排列与连接例如$os \ $username \ $directory \ $git_branch \ $git_status \ $c \ ... \ $time每个 Powerline 分隔符用内联样式着色[](bg:#DA627D fg:#9A348E)这类写法。模块级formatstyle统一配色。如[git_branch] symbol style bg:#FCA17D format $symbol $branch [git_status] style bg:#FCA17D format $all_status$ahead_behind git_branch与git_status共用同一背景色形成连续分段这是 Powerline 提示符的常规手法。 3.directory.substitutions路径文本替换[directory] style bg:#DA627D format $path truncation_length 3 truncation_symbol …/ [directory.substitutions] Documents Downloads Music Pictures 官方注释明确说明替换是顺序敏感的Documents 会先于其他规则生效因此若想把Important Documents替换为某个组合符号必须把它放在Documents之前或直接使用已被替换后的文本作为键。此外该预设还演示了[username] show_always true 自定义style_user/style_root、可选的[os]模块默认disabled true作为 username 的替代方案、以及[time] disabled falsetime_format %R时:分开启时间分段。四、源码级实现starship preset命令如何工作从源码结构看预设功能的实现链条如下CLI 定义src/main.rs 中Preset子命令使用 clap 的value_enum约束预设名这意味着非法预设名会在参数解析阶段就被拒绝-o与--list互斥、-f依赖--output等约束也在此声明。预设名注册表src/print.rs 定义了pub struct Preset(pub static str)并实现 clap 的ValueEnum其value_variants()返回shadow::get_preset_list()——即由构建脚本shadow在编译期生成的预设清单。可以推断预设列表与 TOML 内容均在构建时从仓库文件注入二进制因此运行starship preset --list看到的名称与当前仓库 docs/public/presets/toml/ 目录中的 12 个 TOML 文件一一对应。输出逻辑preset_command 的处理流程是--list时逐行打印preset_list()否则取shadow::get_preset_content(name)得到 TOML 原文若指定-o则调用crate::utils::write_file_atomic(output, content, force)原子写入失败时向 stderr 报错并以退出码 1 结束未指定-o则原样输出到 stdout——因此starship preset name也可以直接cat出来阅读或管道处理。测试验证src/print.rs 的单元测试preset_command_output_to_file与preset_command_output_existing_file_force用include_str!(../docs/public/presets/toml/nerd-font-symbols.toml)作为期望内容断言写入结果证实了仓库中的docs/public/presets/toml/*.toml就是预设命令实际分发的内容源preset_list_returns_one_or_more_items则保证列表非空。这套机制解释了预设文档中“点击图片查看详情”的页面背后结构每个预设页如 docs/presets/nerd-font.md包含前置条件、安装命令starship preset nerd-font-symbols -o ~/.config/starship.toml、TOML 下载链接以及内嵌的完整 TOML 内容与二进制分发的是同一份源文件。五、基于预设二次定制的实践建议先 list 后选不同版本的 Starship 内置预设可能不同以starship preset --list的实际输出为准再对照官方目录确认名称与用途。按需摘取预设本质是完整的starship.toml安装后可以用starship print-config见 src/main.rs 的PrintConfig子命令查看当前生效配置确认预设内容正确加载随后只需保留自己想要的模块段落。例如只想要 Nerd Font 的 git 图标就只保留[git_branch]段的symbol即可。注意覆盖语义starship preset name -o path对已存在的文件需要--force才会覆盖。若已有自定义配置建议先备份如复制为starship.toml.bak或让预设输出到 stdout 后手动合并。Unicode 依赖Nerd Font Symbols、Pastel Powerline、Tokyo Night 等预设大量使用 Nerd Font / 非 ASCII 符号若终端字体或传输链路不支持应选择 No Nerd Fonts 或 Plain Text Symbols 这类去图标化预设——这也正是官方同时提供这两组“正反”预设的原因。未来方向按官方 Presets 文档的说明No Nerd Fonts 预设将在 Starship 的某个未来版本中成为默认预设即新安装的 Starship 将不再默认依赖 Nerd Font当前版本升级前请仍以starship preset --list与实际行为为准。六、延伸阅读仓库内路径预设目录文档docs/presets/README.md及其多语言版本如 docs/ar-SA/presets/README.md全部预设 TOMLdocs/public/presets/toml/预设截图docs/public/presets/img/CLI 入口与子命令定义src/main.rs预设命令实现与测试src/print.rs配置 Schema编辑器校验用docs/public/config-schema.json【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/7 9:16:22 · 阅读 1.2k Starship Preset 预设完整指南：12 个内置风格预设与 starship preset 命令的底层实现
Starship Preset 预设完整指南12 个内置风格预设与 starship preset 命令的底层实现【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本文围绕 Starship 官方文档中的 Presets预设章节展开系统介绍仓库内置的 12 个社区贡献的配置预设它们各自改变提示符的哪些部分、适用什么场景、如何一键安装并结合src/main.rs与src/print.rs的源码说明starship preset命令的解析流程、预设 TOML 文件的存放位置与测试验证方式。读完后你可以为终端选择一套现成风格并具备基于预设二次定制~/.config/starship.toml的能力。一、什么是 Starship Preset如何安装Preset预设是 Starship 官方维护的一组社区提交的完整配置文件starship.toml格式。每个预设针对一类审美或环境诉求例如更换全部模块的图标符号、改用方括号分隔各模块、隐藏运行时版本号、复刻 Pure 提示符风格或实现 Powerline 风格的彩色分段。官方文档 docs/presets/README.md 提供了完整目录其阿拉伯语版本 docs/ar-SA/presets/README.md 内容一致。安装方式非常直接预设内容随二进制分发通过starship preset子命令输出。以官方文档给出的命令为例starship preset nerd-font-symbols -o ~/.config/starship.toml该命令的完整参数在 src/main.rs 中定义Preset子命令参数说明name位置参数要输出的预设名取值由print::Preset枚举限定当传入--list时可省略-o, --output PATH将预设写入文件而不是 stdout与--list互斥-f, --force目标文件已存在时强制覆盖必须与--output同时使用-l, --list列出所有可用预设名因此推荐的实操流程是starship preset --list # 查看当前版本内置的全部预设名 starship preset name -o ~/.config/starship.toml # 写入配置文件值得注意-f参数意味着覆盖现有配置是受控操作——不带--force时写入已存在的文件会报错实现见下文preset_command的write_file_atomic调用避免了误覆盖用户自定义配置。二、官方预设全目录12 个以下逐一覆盖官方文档列出的全部预设每个都附上文档页与 TOML 源文件可直接查看配置细节Nerd Font Symbols文档 / TOML 将所有模块的符号替换为 Nerd Font 图标。前提是在终端中安装并启用 Nerd Font官方示例使用 Fira Code Nerd Font。No Nerd Fonts文档 / TOML 将多个模块的符号改为非 Nerd Font 字符保证整个提示符不依赖 Nerd Font 渲染。官方文档提示该预设将在 Starship 的某个未来版本中成为默认预设。Bracketed Segments文档 / TOML 将所有内置模块的格式改为用方括号显示各自的分段替代默认的 Starship 措辞“via”、“on”等英文连接词。Plain Text Symbols文档 / TOML 将各模块符号替换为纯文本形式适合终端或环境不支持 Unicode 的场景。No Runtime Versions文档 / TOML 隐藏语言运行时的版本号。官方文档特别指出如果你常在容器或虚拟化环境中工作这个预设最合适。No Empty Icons文档 / TOML 当工具链toolset未被检测到时不显示其图标避免提示符中出现“空”模块。Pure Prompt文档 / TOML 模拟 Pure 提示符的外观与行为简洁、失败时才显示额外信息。Pastel Powerline文档 / TOML 受 oh-my-posh 的 M365Princess 主题启发的 Powerline 风格预设同时也是 Starship 中路径替换directory.substitutions机制的官方示例。Tokyo Night文档 / TOML 配色灵感来自 tokyo-night-vscode-theme 这一流行 VS Code 主题。Gruvbox Rainbow文档 / TOML 深受 Pastel Powerline 与 Tokyo Night 两个预设启发使用 Gruvbox 配色的 Powerline 分段。Jetpack文档 / TOML 受 geometry 与 spaceship 提示符启发的准极简预设。Catppuccin Powerline文档 / TOML 在 Gruvbox Rainbow 基础上做最小改动替换为 Catppuccin 主题调色板。每个预设都配有官方截图位于 docs/public/presets/img/ 目录例如 bracketed-segments.png、nerd-font-symbols.png、tokyo-night.png、catppuccin-powerline.png、jetpack.png 等可在文档站中对照选择风格。三、典型预设的配置解剖Nerd Font Symbols符号覆盖的完整清单TOML 源文件 展示了“纯符号覆盖型”预设的典型结构——不改变任何模块的format或style只重写各模块的symbol字段。它覆盖的模块包括aws、azure、battery含 full/charging/discharging/unknown/empty 五种状态符号、buf、bun、c、cpp、cmake、cobol、conda、container、crystal、dart、deno、direnv、directoryread_only符号、docker_context、dotnet、elixir、elm、erlang、fennel、fortran、fossil_branch、gcloud、gleam、git_branch、git_committag_symbol、golang、gradle、guix_shell、haskell、haxe、helm、hg_branch、hostnamessh_symbol、java、jj_bookmark、julia、kotlin、kubernetes、lua、maven、memory_usage、meson、mojo、nats、netns、nim、nix_shell、nodejs、ocaml、odin、opa、openstack、package、perl、php、pijul_channel、pixi、pulumi、purescript、python、raku、red、rlang、ruby、rust、scala、shlvl、singularity、solidity、spack、status、sudo、swift、terraform、vlang、typst、vagrant、xmake、zig。其中最特殊的是[os.symbols]表它按发行版名称逐一定义系统符号如Arch、Debian、Fedora、Macos、Windows、NixOS、Unknown等 60 余个键。这提示了一个定制技巧如果你只想换系统图标可以只摘取[os.symbols]这一段。文件首行为$schema https://starship.rs/config-schema.json指向官方 JSON Schema配合支持 schema 的编辑器可获得 TOML 配置补全与校验。Pastel PowerlinePowerline 分段、格式串与路径替换pastel-powerline.toml 是“结构性改造型”预设的代表它演示了三个高阶配置能力重写全局format控制模块顺序。预设顶部用一个多行format字符串显式编排各模块的排列与连接例如$os \ $username \ $directory \ $git_branch \ $git_status \ $c \ ... \ $time每个 Powerline 分隔符用内联样式着色[](bg:#DA627D fg:#9A348E)这类写法。模块级formatstyle统一配色。如[git_branch] symbol style bg:#FCA17D format $symbol $branch [git_status] style bg:#FCA17D format $all_status$ahead_behind git_branch与git_status共用同一背景色形成连续分段这是 Powerline 提示符的常规手法。 3.directory.substitutions路径文本替换[directory] style bg:#DA627D format $path truncation_length 3 truncation_symbol …/ [directory.substitutions] Documents Downloads Music Pictures 官方注释明确说明替换是顺序敏感的Documents 会先于其他规则生效因此若想把Important Documents替换为某个组合符号必须把它放在Documents之前或直接使用已被替换后的文本作为键。此外该预设还演示了[username] show_always true 自定义style_user/style_root、可选的[os]模块默认disabled true作为 username 的替代方案、以及[time] disabled falsetime_format %R时:分开启时间分段。四、源码级实现starship preset命令如何工作从源码结构看预设功能的实现链条如下CLI 定义src/main.rs 中Preset子命令使用 clap 的value_enum约束预设名这意味着非法预设名会在参数解析阶段就被拒绝-o与--list互斥、-f依赖--output等约束也在此声明。预设名注册表src/print.rs 定义了pub struct Preset(pub static str)并实现 clap 的ValueEnum其value_variants()返回shadow::get_preset_list()——即由构建脚本shadow在编译期生成的预设清单。可以推断预设列表与 TOML 内容均在构建时从仓库文件注入二进制因此运行starship preset --list看到的名称与当前仓库 docs/public/presets/toml/ 目录中的 12 个 TOML 文件一一对应。输出逻辑preset_command 的处理流程是--list时逐行打印preset_list()否则取shadow::get_preset_content(name)得到 TOML 原文若指定-o则调用crate::utils::write_file_atomic(output, content, force)原子写入失败时向 stderr 报错并以退出码 1 结束未指定-o则原样输出到 stdout——因此starship preset name也可以直接cat出来阅读或管道处理。测试验证src/print.rs 的单元测试preset_command_output_to_file与preset_command_output_existing_file_force用include_str!(../docs/public/presets/toml/nerd-font-symbols.toml)作为期望内容断言写入结果证实了仓库中的docs/public/presets/toml/*.toml就是预设命令实际分发的内容源preset_list_returns_one_or_more_items则保证列表非空。这套机制解释了预设文档中“点击图片查看详情”的页面背后结构每个预设页如 docs/presets/nerd-font.md包含前置条件、安装命令starship preset nerd-font-symbols -o ~/.config/starship.toml、TOML 下载链接以及内嵌的完整 TOML 内容与二进制分发的是同一份源文件。五、基于预设二次定制的实践建议先 list 后选不同版本的 Starship 内置预设可能不同以starship preset --list的实际输出为准再对照官方目录确认名称与用途。按需摘取预设本质是完整的starship.toml安装后可以用starship print-config见 src/main.rs 的PrintConfig子命令查看当前生效配置确认预设内容正确加载随后只需保留自己想要的模块段落。例如只想要 Nerd Font 的 git 图标就只保留[git_branch]段的symbol即可。注意覆盖语义starship preset name -o path对已存在的文件需要--force才会覆盖。若已有自定义配置建议先备份如复制为starship.toml.bak或让预设输出到 stdout 后手动合并。Unicode 依赖Nerd Font Symbols、Pastel Powerline、Tokyo Night 等预设大量使用 Nerd Font / 非 ASCII 符号若终端字体或传输链路不支持应选择 No Nerd Fonts 或 Plain Text Symbols 这类去图标化预设——这也正是官方同时提供这两组“正反”预设的原因。未来方向按官方 Presets 文档的说明No Nerd Fonts 预设将在 Starship 的某个未来版本中成为默认预设即新安装的 Starship 将不再默认依赖 Nerd Font当前版本升级前请仍以starship preset --list与实际行为为准。六、延伸阅读仓库内路径预设目录文档docs/presets/README.md及其多语言版本如 docs/ar-SA/presets/README.md全部预设 TOMLdocs/public/presets/toml/预设截图docs/public/presets/img/CLI 入口与子命令定义src/main.rs预设命令实现与测试src/print.rs配置 Schema编辑器校验用docs/public/config-schema.json【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考