Starship Pure Preset 实战指南在任意 Shell 中复刻极简的 Pure 提示符【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starshipStarship 官方预设Preset中pure-preset专门用于模拟知名 Zsh 提示符 Pure 的外观与行为——把多行渲染、极简配色和 Git 状态提示浓缩到一份 TOML 配置里。本文以 docs/uk-UA/presets/pure-preset.md英文原版见 docs/presets/pure-preset.md为核心骨架结合仓库源码与完整 TOML 文件讲解如何一键应用该预设、逐行拆解其配置含义并剖析starship preset命令的底层实现让你既能直接上手也能按需深度定制。Pure Preset 在终端中的实际渲染效果一、Pure Preset 是什么Pure 是 Zsh 生态中著名的极简提示符zsh-pure以「一个字符的提示符、换行分隔、无多余装饰」著称。Starship 的pure-preset并非对 Pure 的逐像素复刻而是模拟emulate其外观与行为提示符主体只有一行❯紫色出错时变红目录、Git 分支等信息紧凑排列Git 状态以单字符缩写呈现语言运行时信息如 Python 虚拟环境被压缩为最小化输出命令执行时间单独着色便于感知长命令耗时。在 Starship 预设目录docs/uk-UA/presets/README.md中它与其他预设Nerd Font Symbols、No Nerd Fonts、Bracketed Segments、Tokyo Night 等并列供用户一键切换整体风格。二、一键应用starship preset 命令使用官方提供的命令即可将本预设写入 Starship 配置文件starship preset pure-preset -o ~/.config/starship.toml该命令将预设内容原子写入~/.config/starship.toml若文件已存在会拒绝覆盖见下文--force。执行后重启终端或重新加载 Shell 配置即可生效。预设的完整 TOML 源码位于 docs/public/presets/toml/pure-preset.toml也可直接下载该文件手动放置。preset 子命令的参数语义从 src/main.rs 的 CLI 定义可以确认preset子命令的完整参数参数含义说明name预设名称pure-preset等与--list互斥--list存在时可省略-o, --output PATH输出到文件默认输出到 stdout与--list冲突-f, --force强制覆盖仅与--output联用文件已存在时覆盖-l, --list列出全部预设名打印所有可用预设后直接返回例如先查看有哪些预设可用starship preset --list把预设内容打印到终端不写入文件用于预览starship preset pure-preset在~/.config/starship.toml已存在且希望整体替换时才需要强制覆盖starship preset pure-preset -o ~/.config/starship.toml -f从源码实现看src/print.rs 的preset_command在指定--output时调用crate::utils::write_file_atomic原子写文件src/utils/mod.rsforce参数决定是否允许覆盖已存在文件未指定--output时则直接写入 stdout。对应的测试用例src/print.rs遍历全部预设逐一调用preset_command确保不 panic另有输出到文件与强制覆盖的专项测试src/print.rs。预设从哪来构建期自动嵌入starship preset的预设清单并非硬编码在源码里而是在构建期从docs/public/presets/toml/目录自动扫描生成。参见 build.rs 的gen_presets_hook读取docs/public/presets/toml/下所有.toml文件以文件名去掉.toml后缀作为预设名生成get_preset_list()的Preset枚举值列表用include_str!把每个 TOML 文件的完整内容编译进二进制生成get_preset_content(name)供运行时取用。因此pure-preset的 TOML 内容在编译时就被固化进 starship 二进制starship preset pure-preset无需联网即可输出完整配置。Preset结构体与ValueEnum实现见 src/print.rs。三、pure-preset.toml 逐项拆解以下是 docs/public/presets/toml/pure-preset.toml 的完整内容也是本预设的全部配置$schema https://starship.rs/config-schema.json format $username\ $hostname\ $directory\ $git_branch\ $git_state\ $git_status\ $cmd_duration\ $line_break\ $python\ $character [directory] style blue [character] success_symbol ❯ error_symbol ❯ vimcmd_symbol ❮ [git_branch] format $branch style bright-black [git_status] format [(*$conflicted$untracked$modified$staged$renamed$deleted) ($ahead_behind$stashed)]($style) style cyan conflicted untracked modified staged renamed deleted stashed ≡ [git_state] format \($state( $progress_current/$progress_total)\) style bright-black [cmd_duration] format $duration style yellow [jj_bookmark] format $bookmark($remote)$diverged( \($overflow_count others\)) style bright-black [python] format $virtualenv style bright-black detect_extensions [] detect_files []1. 顶层 format渲染顺序即设计format $username\ $hostname\ $directory\ $git_branch\ $git_state\ $git_status\ $cmd_duration\ $line_break\ $python\ $characterformat是 Starship 的渲染主模板$模块名按书写顺序从左到右输出行尾反斜杠用于在 TOML 多行字符串中拼接不产生额外换行。这里刻意做到了「Pure 式」的精简仅启用 10 个模块未列出的模块一律不渲染——这正是它看起来「空旷」的直接原因$line_break前是第一行用户名、主机名、目录、Git 信息、命令耗时$line_break后是第二行Python 虚拟环境 ❯提示符与 Pure 的「信息一行、输入一行」布局一致提示符$character位于最后保证光标前只有一个字符。2. directory蓝色目录[directory] style blue仅覆盖默认的目录样式为蓝色保留默认的截断与 Home 替换~逻辑。对应模块实现见 src/modules/directory.rs其默认配置src/configs/directory.rs中truncation_length、truncate_to_repo等行为仍生效。3. character单字符提示符[character] success_symbol ❯ error_symbol ❯ vimcmd_symbol ❮命令成功时显示紫色❯上一条命令退出码非 0 时显示红色❯在 Vim 命令模式下显示绿色❮Shell 需启用vi_mode相关配置才生效参见 src/modules/character.rs 对vimcmd_symbol的处理。这是整个预设「Pure 气质」的点睛之笔状态变化只靠颜色不增加任何文本。4. git_branch紧凑的分支名[git_branch] format $branch style bright-black默认的 git_branch 会带上前缀符号如 这里把 format 精简为只输出分支名本身并用bright-black亮黑/深灰弱化视觉存在感让 Git 分支退居为背景信息。5. git_status纯符号化的状态区[git_status] format [(*$conflicted$untracked$modified$staged$renamed$deleted) ($ahead_behind$stashed)]($style) style cyan conflicted untracked modified staged renamed deleted stashed ≡这是本预设信息密度最高的部分六类工作区状态conflicted 冲突 / untracked 未跟踪 / modified 已修改 / staged 已暂存 / renamed 已重命名 / deleted 已删除的符号全部被替换为零宽字符ZWSPU200B渲染出来不可见——即「有变化但不明说」stashed显示为≡stash 存在时给出唯一可见的 Git 提示$ahead_behind领先/落后上游的箭头保留默认输出外层用(218)前景色ANSI 256 色中的青色系与cyan样式组合上色。配合 git_branch 的深灰与 git_status 的青色形成 Pure 标志性的「分支灰、状态青」配色。默认符号定义可对照 src/configs/git_status.rs如ahead为⇡、behind为⇣、diverged为⇕查看被替换掉的原内容。6. git_state进行中操作提示[git_state] format \($state( $progress_current/$progress_total)\) style bright-black在 rebase / merge / cherry-pick 等操作进行中时以(REBASING 3/10)的括号形式提示使用单引号包裹的 TOML 字符串使\(被当作普通字符传给 Starship 格式化器Starship 用\(转义字面量括号相关解析逻辑见 src/formatter/parser.rs。7. cmd_duration黄色耗时[cmd_duration] format $duration style yellow长命令默认超过 2000ms见 src/configs/cmd_duration.rs 的min_time执行后在提示符末尾以黄色打印耗时如[3.2s]。注意 format 末尾保留了空格用于与后续内容分隔。8. jj_bookmarkJujutsu 支持[jj_bookmark] format $bookmark($remote)$diverged( \($overflow_count others\)) style bright-black对使用 Jujutsujj版本控制的用户用同样的深灰色显示当前 bookmark 及远端、分叉信息。Starship 对jj仓库的支持由 src/modules/jj_bookmark.rs 与 src/context/jj_repo.rs 提供Git 与 jj 的检测上下文见 src/context/git_repo.rs。9. python最小化的虚拟环境提示[python] format $virtualenv style bright-black detect_extensions [] detect_files []只输出虚拟环境名virtualenv隐藏 Python 版本号detect_extensions []与detect_files []清空默认的触发规则默认会因.py文件或pyproject.toml等触发见 src/configs/python.rs使该模块仅在虚拟环境激活时出现——这正是 Pure 的行为不因目录里的 Python 文件而打扰你。四、基于该预设的定制建议应用预设后你可以手动编辑~/.config/starship.toml继续微调想要看到 Git 变化详情把[git_status]中conflicted/untracked/modified等的零宽字符改回默认符号如✗、?、!或删掉对应行恢复默认恢复 Python 版本显示移除[python]中detect_extensions/detect_files两行或改回detect_extensions [py]更换提示符字符success_symbol/error_symbol中的❯可换成➜、λ等任意字符合并到现有配置而非整体替换手动把pure-preset.toml中的format与各模块段复制进现有配置即可避免-o覆盖丢失原有自定义。五、小结Pure Preset 用不到 60 行 TOML 就复刻了 Pure 的核心体验两行布局、单字符彩色提示符、隐式 Git 状态、最小化运行时信息。理解它的每一处配置format顺序、零宽字符技巧、detect_extensions清空不仅能用好这个预设更能举一反三掌握 Starship 的配置心智模型。若要继续探索其他官方预设可浏览 docs/uk-UA/presets/README.md或阅读英文版 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），仅供参考
Starship Pure Preset 实战指南在任意 Shell 中复刻极简的 Pure 提示符【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starshipStarship 官方预设Preset中pure-preset专门用于模拟知名 Zsh 提示符 Pure 的外观与行为——把多行渲染、极简配色和 Git 状态提示浓缩到一份 TOML 配置里。本文以 docs/uk-UA/presets/pure-preset.md英文原版见 docs/presets/pure-preset.md为核心骨架结合仓库源码与完整 TOML 文件讲解如何一键应用该预设、逐行拆解其配置含义并剖析starship preset命令的底层实现让你既能直接上手也能按需深度定制。Pure Preset 在终端中的实际渲染效果一、Pure Preset 是什么Pure 是 Zsh 生态中著名的极简提示符zsh-pure以「一个字符的提示符、换行分隔、无多余装饰」著称。Starship 的pure-preset并非对 Pure 的逐像素复刻而是模拟emulate其外观与行为提示符主体只有一行❯紫色出错时变红目录、Git 分支等信息紧凑排列Git 状态以单字符缩写呈现语言运行时信息如 Python 虚拟环境被压缩为最小化输出命令执行时间单独着色便于感知长命令耗时。在 Starship 预设目录docs/uk-UA/presets/README.md中它与其他预设Nerd Font Symbols、No Nerd Fonts、Bracketed Segments、Tokyo Night 等并列供用户一键切换整体风格。二、一键应用starship preset 命令使用官方提供的命令即可将本预设写入 Starship 配置文件starship preset pure-preset -o ~/.config/starship.toml该命令将预设内容原子写入~/.config/starship.toml若文件已存在会拒绝覆盖见下文--force。执行后重启终端或重新加载 Shell 配置即可生效。预设的完整 TOML 源码位于 docs/public/presets/toml/pure-preset.toml也可直接下载该文件手动放置。preset 子命令的参数语义从 src/main.rs 的 CLI 定义可以确认preset子命令的完整参数参数含义说明name预设名称pure-preset等与--list互斥--list存在时可省略-o, --output PATH输出到文件默认输出到 stdout与--list冲突-f, --force强制覆盖仅与--output联用文件已存在时覆盖-l, --list列出全部预设名打印所有可用预设后直接返回例如先查看有哪些预设可用starship preset --list把预设内容打印到终端不写入文件用于预览starship preset pure-preset在~/.config/starship.toml已存在且希望整体替换时才需要强制覆盖starship preset pure-preset -o ~/.config/starship.toml -f从源码实现看src/print.rs 的preset_command在指定--output时调用crate::utils::write_file_atomic原子写文件src/utils/mod.rsforce参数决定是否允许覆盖已存在文件未指定--output时则直接写入 stdout。对应的测试用例src/print.rs遍历全部预设逐一调用preset_command确保不 panic另有输出到文件与强制覆盖的专项测试src/print.rs。预设从哪来构建期自动嵌入starship preset的预设清单并非硬编码在源码里而是在构建期从docs/public/presets/toml/目录自动扫描生成。参见 build.rs 的gen_presets_hook读取docs/public/presets/toml/下所有.toml文件以文件名去掉.toml后缀作为预设名生成get_preset_list()的Preset枚举值列表用include_str!把每个 TOML 文件的完整内容编译进二进制生成get_preset_content(name)供运行时取用。因此pure-preset的 TOML 内容在编译时就被固化进 starship 二进制starship preset pure-preset无需联网即可输出完整配置。Preset结构体与ValueEnum实现见 src/print.rs。三、pure-preset.toml 逐项拆解以下是 docs/public/presets/toml/pure-preset.toml 的完整内容也是本预设的全部配置$schema https://starship.rs/config-schema.json format $username\ $hostname\ $directory\ $git_branch\ $git_state\ $git_status\ $cmd_duration\ $line_break\ $python\ $character [directory] style blue [character] success_symbol ❯ error_symbol ❯ vimcmd_symbol ❮ [git_branch] format $branch style bright-black [git_status] format [(*$conflicted$untracked$modified$staged$renamed$deleted) ($ahead_behind$stashed)]($style) style cyan conflicted untracked modified staged renamed deleted stashed ≡ [git_state] format \($state( $progress_current/$progress_total)\) style bright-black [cmd_duration] format $duration style yellow [jj_bookmark] format $bookmark($remote)$diverged( \($overflow_count others\)) style bright-black [python] format $virtualenv style bright-black detect_extensions [] detect_files []1. 顶层 format渲染顺序即设计format $username\ $hostname\ $directory\ $git_branch\ $git_state\ $git_status\ $cmd_duration\ $line_break\ $python\ $characterformat是 Starship 的渲染主模板$模块名按书写顺序从左到右输出行尾反斜杠用于在 TOML 多行字符串中拼接不产生额外换行。这里刻意做到了「Pure 式」的精简仅启用 10 个模块未列出的模块一律不渲染——这正是它看起来「空旷」的直接原因$line_break前是第一行用户名、主机名、目录、Git 信息、命令耗时$line_break后是第二行Python 虚拟环境 ❯提示符与 Pure 的「信息一行、输入一行」布局一致提示符$character位于最后保证光标前只有一个字符。2. directory蓝色目录[directory] style blue仅覆盖默认的目录样式为蓝色保留默认的截断与 Home 替换~逻辑。对应模块实现见 src/modules/directory.rs其默认配置src/configs/directory.rs中truncation_length、truncate_to_repo等行为仍生效。3. character单字符提示符[character] success_symbol ❯ error_symbol ❯ vimcmd_symbol ❮命令成功时显示紫色❯上一条命令退出码非 0 时显示红色❯在 Vim 命令模式下显示绿色❮Shell 需启用vi_mode相关配置才生效参见 src/modules/character.rs 对vimcmd_symbol的处理。这是整个预设「Pure 气质」的点睛之笔状态变化只靠颜色不增加任何文本。4. git_branch紧凑的分支名[git_branch] format $branch style bright-black默认的 git_branch 会带上前缀符号如 这里把 format 精简为只输出分支名本身并用bright-black亮黑/深灰弱化视觉存在感让 Git 分支退居为背景信息。5. git_status纯符号化的状态区[git_status] format [(*$conflicted$untracked$modified$staged$renamed$deleted) ($ahead_behind$stashed)]($style) style cyan conflicted untracked modified staged renamed deleted stashed ≡这是本预设信息密度最高的部分六类工作区状态conflicted 冲突 / untracked 未跟踪 / modified 已修改 / staged 已暂存 / renamed 已重命名 / deleted 已删除的符号全部被替换为零宽字符ZWSPU200B渲染出来不可见——即「有变化但不明说」stashed显示为≡stash 存在时给出唯一可见的 Git 提示$ahead_behind领先/落后上游的箭头保留默认输出外层用(218)前景色ANSI 256 色中的青色系与cyan样式组合上色。配合 git_branch 的深灰与 git_status 的青色形成 Pure 标志性的「分支灰、状态青」配色。默认符号定义可对照 src/configs/git_status.rs如ahead为⇡、behind为⇣、diverged为⇕查看被替换掉的原内容。6. git_state进行中操作提示[git_state] format \($state( $progress_current/$progress_total)\) style bright-black在 rebase / merge / cherry-pick 等操作进行中时以(REBASING 3/10)的括号形式提示使用单引号包裹的 TOML 字符串使\(被当作普通字符传给 Starship 格式化器Starship 用\(转义字面量括号相关解析逻辑见 src/formatter/parser.rs。7. cmd_duration黄色耗时[cmd_duration] format $duration style yellow长命令默认超过 2000ms见 src/configs/cmd_duration.rs 的min_time执行后在提示符末尾以黄色打印耗时如[3.2s]。注意 format 末尾保留了空格用于与后续内容分隔。8. jj_bookmarkJujutsu 支持[jj_bookmark] format $bookmark($remote)$diverged( \($overflow_count others\)) style bright-black对使用 Jujutsujj版本控制的用户用同样的深灰色显示当前 bookmark 及远端、分叉信息。Starship 对jj仓库的支持由 src/modules/jj_bookmark.rs 与 src/context/jj_repo.rs 提供Git 与 jj 的检测上下文见 src/context/git_repo.rs。9. python最小化的虚拟环境提示[python] format $virtualenv style bright-black detect_extensions [] detect_files []只输出虚拟环境名virtualenv隐藏 Python 版本号detect_extensions []与detect_files []清空默认的触发规则默认会因.py文件或pyproject.toml等触发见 src/configs/python.rs使该模块仅在虚拟环境激活时出现——这正是 Pure 的行为不因目录里的 Python 文件而打扰你。四、基于该预设的定制建议应用预设后你可以手动编辑~/.config/starship.toml继续微调想要看到 Git 变化详情把[git_status]中conflicted/untracked/modified等的零宽字符改回默认符号如✗、?、!或删掉对应行恢复默认恢复 Python 版本显示移除[python]中detect_extensions/detect_files两行或改回detect_extensions [py]更换提示符字符success_symbol/error_symbol中的❯可换成➜、λ等任意字符合并到现有配置而非整体替换手动把pure-preset.toml中的format与各模块段复制进现有配置即可避免-o覆盖丢失原有自定义。五、小结Pure Preset 用不到 60 行 TOML 就复刻了 Pure 的核心体验两行布局、单字符彩色提示符、隐式 Git 状态、最小化运行时信息。理解它的每一处配置format顺序、零宽字符技巧、detect_extensions清空不仅能用好这个预设更能举一反三掌握 Starship 的配置心智模型。若要继续探索其他官方预设可浏览 docs/uk-UA/presets/README.md或阅读英文版 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），仅供参考
