Starship 纯文本符号预设Plain Text Symbols完全指南在无 Unicode/无 Nerd Font 环境下让提示符保持可读【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本篇技术指南围绕 Starship 内置的Plain Text Symbols纯文本符号预设展开它把 Starship 提示符中几乎所有模块的图标符号替换为普通 ASCII 文本非常适合无 Unicode 字体、字符集受限或希望提示符在任何终端/远程会话中不出现乱码豆腐块的场景。读完本文你将掌握该预设的安装命令、完整配置内容、各模块符号替换的底层逻辑以及如何在预设基础上按需二次定制。该预设解决什么问题Starship 默认会为每个模块语言运行时、Git 状态、云平台、操作系统等输出 Nerd Font 专属符号。虽然观感现代但它要求终端字体必须包含 Nerd Font 字形否则这些字符会渲染成方框豆腐块提示符会变得难以辨认。Plain Text Symbols 预设的定位非常明确不依赖任何特殊字体即可阅读。正如仓库英文文档所描述的This preset changes the symbols for each module into plain text. Great if you dont have access to Unicode.该预设将每个模块的符号改为纯文本当你不具备 Unicode 访问能力时非常适用。它把形如、⎈、☁的图标统一替换为rust、kubernetes、aws之类的人类可读 ASCII 文本让提示符在 SSH、串口、纯文本终端、老旧系统或任何编码受限的环境中都能正常显示。相关预设总览见 docs/presets/README.md本文对应的预设页面还有德语等多语言版本如 docs/de-DE/presets/plain-text.md各语言版本内容一致。安装与使用一条命令写出配置文件预设的官方使用方式是在仓库任一模块源码的 main.rs 预设子命令声明 所支撑的preset命令starship preset plain-text-symbols -o ~/.config/starship.toml执行后Starship 会把plain-text-symbols预设的完整 TOML 内容写出到默认配置文件~/.config/starship.toml即STARSHIP_CONFIG指向的位置覆盖原有的提示符配置并立即生效重启终端或重新加载 shell 后即可看到纯文本符号效果。该命令还有几个实用的配套能力-o, --output FILE将预设输出到指定文件而非 stdout上面示例中的~/.config/starship.toml即由它写入-f, --force当目标文件已存在时强制覆盖默认遇到已存在文件会拒绝写入以防误覆盖--list列出二进制内嵌的全部可用预设名称。上述选项在 main.rs 的参数定义 中有对应实现其行为由 print.rs 中的 preset 命令处理逻辑 支撑。运行时预设的 TOML 内容并不读取自仓库文件而是由构建脚本 build.rs 通过include_str方式编译期内嵌进二进制再由 print.rs 中的get_preset_list/get_preset_content通道输出——因此只要安装了 Starship 就可以离线生成该预设。相关逻辑还有配套单元测试见 print.rs 的测试区其中直接以仓库内的docs/public/presets/toml/nerd-font-symbols.toml作为比对基准验证写出内容一致。完整配置逐段精读下面这份配置文件即该预设的全部内容仓库中的权威副本位于 docs/public/presets/toml/plain-text-symbols.toml$schema https://starship.rs/config-schema.json continuation_prompt . [character] success_symbol error_symbol x vimcmd_symbol vimcmd_visual_symbol vimcmd_replace_symbol vimcmd_replace_one_symbol [git_commit] tag_symbol tag [git_status] ahead behind diverged renamed r deleted x [aws] symbol aws [azure] symbol az [battery] full_symbol full charging_symbol charging discharging_symbol discharging unknown_symbol unknown empty_symbol empty [buf] symbol buf [bun] symbol bun [c] symbol C [cpp] symbol C [cobol] symbol cobol [conda] symbol conda [container] symbol container [crystal] symbol cr [cmake] symbol cmake [daml] symbol daml [dart] symbol dart [deno] symbol deno [dotnet] format via $symbol($version )(target $tfm ) symbol .NET [directory] read_only ro [docker_context] symbol docker [elixir] symbol exs [elm] symbol elm [erlang] symbol erl [fennel] symbol fnl [fortran] symbol fortran [fossil_branch] symbol fossil truncation_symbol ... [gcloud] symbol gcp [git_branch] symbol git truncation_symbol ... [gleam] symbol gleam [golang] symbol go [gradle] symbol gradle [guix_shell] symbol guix [haskell] symbol haskell [haxe] symbol hx [helm] symbol helm [hg_branch] symbol hg truncation_symbol ... [hostname] ssh_symbol ssh [java] symbol java [jj_bookmark] symbol jj truncation_symbol ... [jobs] symbol * [julia] symbol jl [kotlin] symbol kt [kubernetes] symbol kubernetes [lua] symbol lua [maven] symbol maven [nodejs] symbol nodejs [memory_usage] symbol memory [meson] symbol meson truncation_symbol ... [mojo] symbol mojo [nats] symbol nats [netns] symbol netns [nim] symbol nim [nix_shell] symbol nix [ocaml] symbol ml [odin] symbol odin [opa] symbol opa [openstack] symbol openstack [os.symbols] AIX aix Alpaquita alq AlmaLinux alma Alpine alp ALTLinux alt Amazon amz Android andr AOSC aosc Arch rch Artix atx Bazzite bazz Bluefin blfn CachyOS cach CentOS cent Debian deb DragonFly dfbsd Elementary elem Emscripten emsc EndeavourOS ndev Fedora fed FreeBSD fbsd Garuda garu Gentoo gent HardenedBSD hbsd Hurd hurd Illumos lum Ios ios InstantOS inst Kali kali KDENeon kde Linux lnx Mabox mbox Macos mac Manjaro mjo Mariner mrn MidnightBSD mid Mint mint NetBSD nbsd NixOS nix Nobara nbra OpenBSD obsd OpenCloudOS ocos openEuler oeul openSUSE osuse OracleLinux orac PikaOS pika Pop pop Raspbian rasp Redhat rhl RedHatEnterprise rhel RockyLinux rky Redox redox Solus sol SUSE suse Ubuntu ubnt Ultramarine ultm Unknown unk Uos uos Void void Windows win Zorin zorn [package] symbol pkg [perl] symbol pl [php] symbol php [pijul_channel] symbol pijul truncation_symbol ... [pixi] symbol pixi [pulumi] symbol pulumi [purescript] symbol purs [python] symbol py [quarto] symbol quarto [raku] symbol raku [red] symbol red [rlang] symbol r [ruby] symbol rb [rust] symbol rs [scala] symbol scala [shlvl] symbol shlvl [spack] symbol spack [solidity] symbol solidity [status] symbol x not_executable_symbol noexec not_found_symbol notfound sigint_symbol sigint signal_symbol sig [sudo] symbol sudo [swift] symbol swift [typst] symbol typst [vagrant] symbol vagrant [terraform] symbol terraform [xmake] symbol xmake [zig] symbol zig 配置文件结构解析这份 TOML 的写法遵循 Starship 配置的通用规则每个[section]对应一个模块模块下覆写的是该模块在 src/modules/ 中定义的默认 symbol 等参数。预设相当于一份「全局差异补丁」——它并不重新定义整个提示符而只改动符号类字段因此语言、格式等其余默认行为保持不变。顶层与交互类character、continuation_prompt、jobs、status这些字段控制「命令行本体」的呈现是 ASCII 化的核心区域配置项纯文本值说明continuation_prompt.多行续行提示符从默认的 改为一个.亮黑色[character] success_symbol命令成功时的提示符从默认箭头图标改为[character] error_symbolx上条命令失败时显示红色xvimcmd_symbol/vimcmd_visual_symbol/Vim 普通模式与可视模式下显示vimcmd_replace_symbol/vimcmd_replace_one_symbol替换与单字符替换模式同为紫色[jobs] symbol*后台任务标记从图标改为*[status] symbolx退出码非零时的状态符号为红色x[status] not_executable_symbol/not_found_symbolnoexec/notfound区分「不可执行」与「命令不存在」两种失败场景[status] sigint_symbol/signal_symbolsigint/sig被 SIGINT 中断与其它信号终止时分别标记从源码实现看character、status、jobs对应 src/modules/character.rs、src/modules/status.rs、src/modules/jobs.rs这些 symbol 均为可配置字段预设只替换其取值、不改变显示逻辑。Git 与版本控制类模块/字段纯文本值说明[git_branch] symbolgit分支前缀从分支图标改为git[git_commit] tag_symboltagcommit 的 tag 标记[git_status] ahead/behind/领先/落后上游的箭头符号[git_status] diverged分叉状态[git_status] renamed/deletedr/x已重命名/已删除文件标记[hg_branch]、[pijul_channel]、[fossil_branch]、[jj_bookmark]hg/pijul/fossil/jjMercurial、Pijul、Fossil、Jujutsu 的分支/书签前缀上述各分支模块的truncation_symbol...超长分支名截断符统一为...Git 相关配置会在 src/modules/git_status.rs、src/modules/git_branch.rs 等模块中消费ahead/behind等内容仍由 git 状态探测逻辑计算符号替换不影响探测结果。云平台与基础设施模块纯文本值说明awsawsAWSazureazAzuregcloudgcpGoogle Clouddocker_contextdockerDocker 上下文kuberneteskubernetesk8s 集群上下文helmhelmHelmopenstackopenstackOpenStackspackspackSpackterraformterraformTerraform 工作区pulumipulumiPulumiopaopaOPAsudosudosudo 凭据缓存提示containercontainer容器环境标记natsnatsNATS 上下文netnsnetns网络命名空间可以看到纯文本策略下云/容器前缀均采用「小写名称 空格」的规整模式例如aws、docker、kubernetes保证各段之间有清晰间隔。编程语言与工具链这是改动面最大的一组覆盖绝大多数语言运行时模块对应源码见 src/modules/ 下同名文件。它采用两种命名风格完整名称式cobol、cmake、daml、elm、fortran、gleam、gradle、haskell、java、kotlin、lua、maven、mojo、nim、nodejs、odin、quarto、scala、swift、typst、vagrant、zig、xmake、meson、guix对应 guix_shell、bun、deno、buf等短名/扩展名式Cc、Ccpp、crcrystal、dart、exselixir、erlerlang、fnlfennel、hxhaxe、jljulia、ktkotlin、mlocaml、plperl、php、purspurescript、pypython、rrlang、rbruby、rsrust、gogolang、.NETdotnet等。其中值得注意的两处特例[dotnet]段不仅改了symbol .NET 还覆写了整个format via $symbol($version )(target $tfm )把原本依赖 Nerd Font 的默认格式模板替换为仅含 symbol/version/tfm 的纯文本布局[rlang] symbol r 是后补的模块——在 CHANGELOG.md 中可以查到 add missing rlang to plain-text-symbols preset 的修复记录这说明该预设会随 Starship 新增模块同步维护属于「活文档」。系统信息类模块纯文本值说明[hostname] ssh_symbolssh通过 SSH 连接时主机名前缀[directory] read_onlyro只读目录后缀[memory_usage] symbolmemory内存占用模块[battery] full/charging/discharging/unknown/emptyfull/charging/discharging/unknown/empty电池五种状态分别用英文单词[shlvl] symbolshlvlshell 层级计数os.symbols是改动规模最大的单张表为约 60 个操作系统/发行版分配了三到五字母缩写Debian deb 、Ubuntu ubnt 、Fedora fed 、Arch rch 、Macos mac 、Windows win 、NixOS nix 、openSUSE osuse 等未识别的系统回落到Unknown unk 。该配置与 src/modules/os.rs 的符号查找逻辑配套——文件注释中明确指引开发者在新增系统时要同步维护这份预设的os.symbols表见 src/modules/os.rs 附近从源码角度印证了该表与模块实现的一致性维护关系。在预设基础上二次定制预设给出的是一份保守、可读性优先的基线你完全可以把它当作起点继续微调。例如在写出预设后手动在~/.config/starship.toml中追加或覆盖某个符号[character] success_symbol $ # 把成功提示符从 改成常用的 $ [git_branch] symbol branch # 把 git 前缀改成自己习惯的词注意三点预设是整体覆盖式写出的重复执行starship preset plain-text-symbols -o ~/.config/starship.toml会把当前配置整体替换为预设内容若已做过定制请先备份或使用-f之外的交互确认后再覆盖symbol字段保留尾部空格如aws是刻意设计——保证符号与后续文本如版本号之间有间距想临时体验而不写配置可以把预设内容直接当作普通 TOML 片段合并进现有配置只保留自己需要的[section]。如果你希望与其它预设组合可以先用starship preset --list查看所有可用项还包括 Nerd Font Symbols、No Runtime Versions、Tokyo Night 等社区预设详见 docs/presets/README.md然后手工合并各预设中你需要的片段而不是让后执行的预设整份覆盖前一份。小结Plain Text Symbols 预设用「全 ASCII 化」的思路解决了提示符对特殊字体的依赖问题它以覆盖近百个模块符号的 TOML 配置文件见 docs/public/presets/toml/plain-text-symbols.toml把 git、云平台、语言运行时、操作系统等各类标记统一替换为纯文本字符集受限环境下依旧清晰可辨。其使用链路非常轻量——预设内容随二进制内嵌build.rs执行starship preset plain-text-symbols -o ~/.config/starship.toml即可一键启用同时它采用「仅覆写符号字段」的差异式配置结构用户可以在其上自由微调兼顾了开箱即用与高度可定制。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
