Starship Pure Preset 深度指南用纯配置在任意 Shell 复刻极简 Pure 提示符【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starshipStarship 内置的Pure Preset是一份完整的官方预设配置法语文档见 docs/fr-FR/presets/pure-preset.md内容与英文原版一致用于把 Starship 的默认多模块提示符改造成经典 zsh 插件 [Pure] 的极简两行风格上方只展示目录与 Git 状态下方用单字符❯作为输入符。阅读本文后你将能一键应用该预设、逐段读懂它的 TOML 配置并能在源码层面定位到每条格式字符串对应的模块实现从而按自己的喜好继续微调。一、什么是 Pure 预设它模仿了什么Pure 是一个以“只显示必要信息”著称的 zsh 提示符方案没有花哨的分隔符与图标堆砌提示符被拆成上下两行并通过颜色和少量符号传达 Git 工作区状态。Starship 的社区预设仓库总览见 docs/presets/README.md将这一套视觉与交互约定翻译成了跨 Shell 的 Starship TOML 配置使 bash、zsh、fish、PowerShell、Nushell 等所有 Starship 支持的 Shell 都能获得相同的观感。该预设对应的完整配置文件存放在仓库的 docs/public/presets/toml/pure-preset.toml。从文件头部的$schema可以看出它是一份标准 Starship 配置可对照仓库自带的 JSON Schemadocs/public/config-schema.json校验字段合法性。二、安装前提与一行命令应用应用前请确保本机已正确安装并初始化 Starship安装步骤参见 docs/installing/README.md。随后只需执行预设命令starship preset pure-preset -o ~/.config/starship.toml命令执行后Pure 预设的完整配置会被写入~/.config/starship.toml新开终端或source一次 Shell 初始化脚本即可生效。理解这条命令的细节有助于你灵活使用不带-o时预设内容直接打印到标准输出可自行重定向starship preset pure-preset ~/.config/starship.toml若目标文件~/.config/starship.toml已存在且非空Starship 会拒绝覆盖并报错此时需追加-f/--force强制写入-l/--list可列出所有可用的预设名称。从源码看preset子命令由 src/main.rs 定义其实现位于 src/print.rs预设内容在编译期被打包进二进制shadow::get_preset_content运行时按名称取出通过write_file_atomic原子写入目标文件——因此不会出现写到一半进程被中断导致配置文件损坏的情况。如果你不想执行命令也可以直接查看仓库中的 pure-preset.toml把内容原样粘贴到自己的配置文件里效果完全等价。三、配置全解析逐段拆解预设 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 []3.1 顶层format两行式布局的骨架顶层format是提示符的“总导演”它按书写顺序渲染各模块。这里的多行字符串内每个模块后面都紧跟一个\作用是把换行转义掉详见 docs/advanced-config/README.md 中关于 format 字符串与转义的说明即“视觉上换行、实际不产生换行”只有显式的$line_break才会真正断行。因此最终提示符被分成两行第一行信息行用户名 → 主机名 → 目录 → Git 分支 → Git 状态 → Git 过程状态 → 上条命令耗时第二行输入行Python 虚拟环境名若启用→ 提示符字符❯。对比 Starship 默认布局这里刻意省略了语言运行时版本、包管理器、$all通配符等大量模块——这正是“Pure 式极简”的核心实现手段不显示就不产生噪音。3.2[directory]蓝色目录[directory]模块只设置style blue其余沿用默认行为默认会展示路径截断、读写符号等逻辑实现见 src/modules/directory.rs 与配置定义 src/configs/directory.rs。Pure 的经典观感中当前路径正是醒目的蓝色第一眼即可定位“我在哪”。3.3[character]❯ / ❮ 状态符号这是该预设最具辨识度的部分命令执行成功时显示紫色❯命令以非零状态退出时显示红色❯处于 vim 普通模式时需配合 Shell 的 vim 模式显示绿色❮。对应实现可参考 src/configs/character.rs 与 src/modules/character.rssuccess_symbol、error_symbol、vimcmd_symbol三个配置项决定不同上下文的字符与配色。这里的purple、red、green都是 Starship 内置样式名而[git_status]中出现的(218)则是 256 色索引Pure 调色板里的粉紫色说明该预设同时用到了“颜色名称”和“色号”两种指定方式。3.4[git_branch]、[git_state]与[git_status]Git 状态三件套git_branchformat $branch意味着只显示分支名不显示上游、标签、提交哈希等附加信息style bright-black让分支名以柔和的亮黑色出现不抢目录的蓝色风头。git_state当处于 merge/rebase/cherry-pick 等中间状态时在括号内显示状态名与进度$progress_current/$progress_total同样用bright-black弱化显示。git_status这是最能体现“信息压缩”的一段。格式串[(*$conflicted$untracked$modified$staged$renamed$deleted) ($ahead_behind$stashed)]($style)中字面量*是“工作区有变动”的主标记紧随其后的$conflicted…$deleted六个变量全部被设为U200B零宽空格对 TOML 文件做字节级检查可确认E2 80 8Bstashed 则映射为≡。这样设计的效果是有未提交改动时提示符出现粉紫色的(*片段醒目但极简有 stash 时出现≡符号且它来自$stashed变量领先/落后上游时$ahead_behind按 Starship 默认语义渲染↑/↓整体style cyan。Git 状态的探测与符号展开逻辑见 src/modules/git_status.rs 与 src/configs/git_status.rssrc/modules/git_state.rs 则负责 merge/rebase 等中间态的检测。3.5[cmd_duration]黄色的耗时提示format $duration 在耗时超过阈值时以黄色展示上一条命令的执行时长style yellow。这是 Pure“不打扰”哲学的延续——只有命令跑得够久才值得提示帮助你判断是否有命令卡住。3.6[jj_bookmark]Jujutsu 用户的同级替代预设为使用 Jujutsujj版本控制的用户提供了与 git_branch 对齐的展示$bookmark($remote)$diverged( \\($overflow_count others\\))显示 bookmark 名、远程前缀与分叉信息风格同样为bright-black。可对照 src/configs/jj_bookmark.rs 与 src/modules/jj_bookmark.rs 查看各变量的默认含义。3.7[python]只显示虚拟环境[python] format $virtualenv style bright-black detect_extensions [] detect_files []format中只保留$virtualenv因此不会显示 Python 版本号更重要的是detect_extensions与detect_files均被清空源码侧对 python 模块的探测选项可参考 src/configs/python.rs避免仅凭一个.py文件就触发显示只有当虚拟环境真正激活时才出现虚拟环境名——这正是 Pure 在激活 venv 时提示的等价行为。四、运行效果对照一张截图读懂全部状态上文配图docs/public/presets/img/pure-preset.png完整演示了这套状态语言在一个真实 Git 工作流中的变化终端状态提示符表现对应配置工作区有未提交改动git-repo trunk*git_status 中的粉紫色(*与$modified等状态变量执行git stash -q后git-repo trunk ≡未提交改动被收走$stashed渲染出≡执行git stash pop -q后git-repo trunk*改动恢复*重新出现git commit -am提交后git-repo trunk ↑本地领先上游$ahead_behind渲染↑同时可以看到当前目录git-repo始终为蓝色每条命令前是独立的❯输入符命令执行完的提示符整体落在新一行——即第二行只保留“输入提示”这一件事。这种“信息行 输入行”的分离正是 Pure 预设的核心交互模型。五、在这个基础上继续定制Pure 预设不是终点而是起点。因为它就是一份普通 TOML你可以直接在~/.config/starship.toml上叠加修改改颜色把style blue换成任意内置样式名cyan、bright-blue、#RRGGBB或 256 色号见 docs/config/README.md 的样式说明增删模块在第一行的 format 串中插入$package、$nodejs、$time等模块或直接删除不需要的模块引用各模块文档同样汇总在 docs/config/README.md恢复运行时版本提示把 Python 段的detect_extensions []、detect_files []移除$version变量便会按需出现如果只想隐藏版本、保留探测可参考同目录下的 no-runtimes 预设 的做法换字符风格不希望用❯这类 Unicode 字符时可替换success_symbol等为纯 ASCII参考 plain-text 预设 的思路。修改后运行starship explain源码实现见 src/main.rs 的Explain子命令即可查看当前提示符各模块的实时渲染结果与耗时便于验证改动效果。六、小结与源码阅读路线Pure 预设用约 50 行 TOML 完成了传统上需要编写整个 zsh 插件才能实现的效果其核心思想可以概括为三点两行式布局$line_break分隔、克制的信息选择只留目录/Git/耗时/虚拟环境、以颜色与单个符号承载状态❯/(*/≡/↑。若想进一步深挖建议沿以下仓库路径阅读预设命令与本文件出处src/main.rs、src/print.rs、docs/presets/pure-preset.md、pure-preset.toml模块实现character、directory、git_branch、git_status、git_state、cmd_duration、python、jj_bookmark 的源码位于 src/modules 与 src/configs 对应同名文件中配置总览与所有预设列表docs/config/README.md、docs/presets/README.md。一个终端上的“极简”在代码层面往往意味着一次深思熟虑的取舍——Pure 预设就是理解 Starship“最小化、可无限定制”设计哲学的最佳入门样例。【免费下载链接】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 Pure Preset 深度指南用纯配置在任意 Shell 复刻极简 Pure 提示符【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starshipStarship 内置的Pure Preset是一份完整的官方预设配置法语文档见 docs/fr-FR/presets/pure-preset.md内容与英文原版一致用于把 Starship 的默认多模块提示符改造成经典 zsh 插件 [Pure] 的极简两行风格上方只展示目录与 Git 状态下方用单字符❯作为输入符。阅读本文后你将能一键应用该预设、逐段读懂它的 TOML 配置并能在源码层面定位到每条格式字符串对应的模块实现从而按自己的喜好继续微调。一、什么是 Pure 预设它模仿了什么Pure 是一个以“只显示必要信息”著称的 zsh 提示符方案没有花哨的分隔符与图标堆砌提示符被拆成上下两行并通过颜色和少量符号传达 Git 工作区状态。Starship 的社区预设仓库总览见 docs/presets/README.md将这一套视觉与交互约定翻译成了跨 Shell 的 Starship TOML 配置使 bash、zsh、fish、PowerShell、Nushell 等所有 Starship 支持的 Shell 都能获得相同的观感。该预设对应的完整配置文件存放在仓库的 docs/public/presets/toml/pure-preset.toml。从文件头部的$schema可以看出它是一份标准 Starship 配置可对照仓库自带的 JSON Schemadocs/public/config-schema.json校验字段合法性。二、安装前提与一行命令应用应用前请确保本机已正确安装并初始化 Starship安装步骤参见 docs/installing/README.md。随后只需执行预设命令starship preset pure-preset -o ~/.config/starship.toml命令执行后Pure 预设的完整配置会被写入~/.config/starship.toml新开终端或source一次 Shell 初始化脚本即可生效。理解这条命令的细节有助于你灵活使用不带-o时预设内容直接打印到标准输出可自行重定向starship preset pure-preset ~/.config/starship.toml若目标文件~/.config/starship.toml已存在且非空Starship 会拒绝覆盖并报错此时需追加-f/--force强制写入-l/--list可列出所有可用的预设名称。从源码看preset子命令由 src/main.rs 定义其实现位于 src/print.rs预设内容在编译期被打包进二进制shadow::get_preset_content运行时按名称取出通过write_file_atomic原子写入目标文件——因此不会出现写到一半进程被中断导致配置文件损坏的情况。如果你不想执行命令也可以直接查看仓库中的 pure-preset.toml把内容原样粘贴到自己的配置文件里效果完全等价。三、配置全解析逐段拆解预设 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 []3.1 顶层format两行式布局的骨架顶层format是提示符的“总导演”它按书写顺序渲染各模块。这里的多行字符串内每个模块后面都紧跟一个\作用是把换行转义掉详见 docs/advanced-config/README.md 中关于 format 字符串与转义的说明即“视觉上换行、实际不产生换行”只有显式的$line_break才会真正断行。因此最终提示符被分成两行第一行信息行用户名 → 主机名 → 目录 → Git 分支 → Git 状态 → Git 过程状态 → 上条命令耗时第二行输入行Python 虚拟环境名若启用→ 提示符字符❯。对比 Starship 默认布局这里刻意省略了语言运行时版本、包管理器、$all通配符等大量模块——这正是“Pure 式极简”的核心实现手段不显示就不产生噪音。3.2[directory]蓝色目录[directory]模块只设置style blue其余沿用默认行为默认会展示路径截断、读写符号等逻辑实现见 src/modules/directory.rs 与配置定义 src/configs/directory.rs。Pure 的经典观感中当前路径正是醒目的蓝色第一眼即可定位“我在哪”。3.3[character]❯ / ❮ 状态符号这是该预设最具辨识度的部分命令执行成功时显示紫色❯命令以非零状态退出时显示红色❯处于 vim 普通模式时需配合 Shell 的 vim 模式显示绿色❮。对应实现可参考 src/configs/character.rs 与 src/modules/character.rssuccess_symbol、error_symbol、vimcmd_symbol三个配置项决定不同上下文的字符与配色。这里的purple、red、green都是 Starship 内置样式名而[git_status]中出现的(218)则是 256 色索引Pure 调色板里的粉紫色说明该预设同时用到了“颜色名称”和“色号”两种指定方式。3.4[git_branch]、[git_state]与[git_status]Git 状态三件套git_branchformat $branch意味着只显示分支名不显示上游、标签、提交哈希等附加信息style bright-black让分支名以柔和的亮黑色出现不抢目录的蓝色风头。git_state当处于 merge/rebase/cherry-pick 等中间状态时在括号内显示状态名与进度$progress_current/$progress_total同样用bright-black弱化显示。git_status这是最能体现“信息压缩”的一段。格式串[(*$conflicted$untracked$modified$staged$renamed$deleted) ($ahead_behind$stashed)]($style)中字面量*是“工作区有变动”的主标记紧随其后的$conflicted…$deleted六个变量全部被设为U200B零宽空格对 TOML 文件做字节级检查可确认E2 80 8Bstashed 则映射为≡。这样设计的效果是有未提交改动时提示符出现粉紫色的(*片段醒目但极简有 stash 时出现≡符号且它来自$stashed变量领先/落后上游时$ahead_behind按 Starship 默认语义渲染↑/↓整体style cyan。Git 状态的探测与符号展开逻辑见 src/modules/git_status.rs 与 src/configs/git_status.rssrc/modules/git_state.rs 则负责 merge/rebase 等中间态的检测。3.5[cmd_duration]黄色的耗时提示format $duration 在耗时超过阈值时以黄色展示上一条命令的执行时长style yellow。这是 Pure“不打扰”哲学的延续——只有命令跑得够久才值得提示帮助你判断是否有命令卡住。3.6[jj_bookmark]Jujutsu 用户的同级替代预设为使用 Jujutsujj版本控制的用户提供了与 git_branch 对齐的展示$bookmark($remote)$diverged( \\($overflow_count others\\))显示 bookmark 名、远程前缀与分叉信息风格同样为bright-black。可对照 src/configs/jj_bookmark.rs 与 src/modules/jj_bookmark.rs 查看各变量的默认含义。3.7[python]只显示虚拟环境[python] format $virtualenv style bright-black detect_extensions [] detect_files []format中只保留$virtualenv因此不会显示 Python 版本号更重要的是detect_extensions与detect_files均被清空源码侧对 python 模块的探测选项可参考 src/configs/python.rs避免仅凭一个.py文件就触发显示只有当虚拟环境真正激活时才出现虚拟环境名——这正是 Pure 在激活 venv 时提示的等价行为。四、运行效果对照一张截图读懂全部状态上文配图docs/public/presets/img/pure-preset.png完整演示了这套状态语言在一个真实 Git 工作流中的变化终端状态提示符表现对应配置工作区有未提交改动git-repo trunk*git_status 中的粉紫色(*与$modified等状态变量执行git stash -q后git-repo trunk ≡未提交改动被收走$stashed渲染出≡执行git stash pop -q后git-repo trunk*改动恢复*重新出现git commit -am提交后git-repo trunk ↑本地领先上游$ahead_behind渲染↑同时可以看到当前目录git-repo始终为蓝色每条命令前是独立的❯输入符命令执行完的提示符整体落在新一行——即第二行只保留“输入提示”这一件事。这种“信息行 输入行”的分离正是 Pure 预设的核心交互模型。五、在这个基础上继续定制Pure 预设不是终点而是起点。因为它就是一份普通 TOML你可以直接在~/.config/starship.toml上叠加修改改颜色把style blue换成任意内置样式名cyan、bright-blue、#RRGGBB或 256 色号见 docs/config/README.md 的样式说明增删模块在第一行的 format 串中插入$package、$nodejs、$time等模块或直接删除不需要的模块引用各模块文档同样汇总在 docs/config/README.md恢复运行时版本提示把 Python 段的detect_extensions []、detect_files []移除$version变量便会按需出现如果只想隐藏版本、保留探测可参考同目录下的 no-runtimes 预设 的做法换字符风格不希望用❯这类 Unicode 字符时可替换success_symbol等为纯 ASCII参考 plain-text 预设 的思路。修改后运行starship explain源码实现见 src/main.rs 的Explain子命令即可查看当前提示符各模块的实时渲染结果与耗时便于验证改动效果。六、小结与源码阅读路线Pure 预设用约 50 行 TOML 完成了传统上需要编写整个 zsh 插件才能实现的效果其核心思想可以概括为三点两行式布局$line_break分隔、克制的信息选择只留目录/Git/耗时/虚拟环境、以颜色与单个符号承载状态❯/(*/≡/↑。若想进一步深挖建议沿以下仓库路径阅读预设命令与本文件出处src/main.rs、src/print.rs、docs/presets/pure-preset.md、pure-preset.toml模块实现character、directory、git_branch、git_status、git_state、cmd_duration、python、jj_bookmark 的源码位于 src/modules 与 src/configs 对应同名文件中配置总览与所有预设列表docs/config/README.md、docs/presets/README.md。一个终端上的“极简”在代码层面往往意味着一次深思熟虑的取舍——Pure 预设就是理解 Starship“最小化、可无限定制”设计哲学的最佳入门样例。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考