Starship Plain Text Symbols 预设全解析把提示符改造成纯 ASCII 文本的完整配置指南【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship导读Starship 默认在每个模块前展示 emoji / Nerd Font 图形符号但并非所有终端都支持 Unicode。本文以官方预设Plain Text Symbols配置文件名plain-text-symbols为核心系统讲解如何用一条starship preset命令把命令提示符中几乎所有模块符号替换为纯文本标识并深入到该预设的 TOML 源码、Starship 命令行的preset子命令实现与模块源码帮助你理解符号从哪来、怎么被替换、还能如何自定义彻底摆脱 Unicode 字体依赖。一、这个预设解决什么问题Starship 是一个跨 shell 的极简提示符默认情况下每个模块前面都会带一个图形符号icon。例如 Git 分支、语言运行时Python / Go / Rust 等、操作系统发行版都使用 emoji 或 Nerd Font 专有字形。这些字形正常渲染的前提是终端使用的字体包含对应 Unicode 码位Nerd Font 字形尤其依赖专用字体终端编码与操作系统能正确传递多字节字符。Plain Text Symbols 预设正是针对无法访问 Unicode 的环境设计的。所谓 plain text指的是把每个模块的 symbol 全部替换成 ASCII 可见字符加空格的形式例如 Go 的symbol go 、Rust 的symbol rs 、git 分支的symbol git 。这样即使终端只支持最基础的字库例如某些嵌入式串口终端、极简远程会话、无中文/无 emoji 字体渲染的环境提示符也能完整、对齐地显示。这套预设的官方定位可以看预设索引页与文档本体的说明This preset changes the symbols for each module into plain text. Great if you dont have access to Unicode.Plain Text Symbols 预设运行效果截图二、一键应用starship preset命令与输出行为原文档给出的唯一配置方式就是把内置预设输出到用户的配置文件starship preset plain-text-symbols -o ~/.config/starship.toml命令含义拆解plain-text-symbols预设名称是 Starship 二进制的内置 preset 之一-o, --output FILE把生成的 TOML 写到指定文件而不是打印到 stdout默认会写入~/.config/starship.toml这正是 Starship 在 Linux / macOS 上读取的主配置文件路径。关于这条命令的底层实现从源码src/main.rs中可以确认Starship 在 CLI 层专门定义了Preset子命令参见 src/main.rs#L102-L116支持三个参数参数含义取自 CLI 定义注释name要打印的预设名称value_enum只能传内置预设名-o, --output把预设输出到文件而非 stdout且与--list互斥-f, --force当输出文件已存在时强制覆盖依赖--output-l, --list列出所有可用预设名称也就是说若你的配置文件已经存在直接运行上面的命令可能会因文件已存在而失败此时需要追加--forcestarship preset plain-text-symbols -o ~/.config/starship.toml --force如果你只是想查看某个预设内容、或者把它合并进已有配置可以不加-o让预设打印到 stdout再重定向到文件starship preset plain-text-symbols starship preset plain-text-symbols ~/.config/starship.toml starship preset --listpreset命令的实际处理函数为print::preset_command见 src/print.rs#L530。同一文件中的单元测试如 src/print.rs#L682-L704验证了preset_command对全部预设取值都不会 panic并且输出到文件的内容与该预设的源 TOML 完全一致而输出文件已存在时强制覆盖的行为也由 src/print.rs#L707-L724 的测试用例覆盖。测试中比较的基准文件路径为../docs/public/presets/toml/nerd-font-symbols.toml说明文档目录下的 TOML 就是预设的真实数据源构建期通过include_str!内嵌进二进制——因此即使不联网、不携带该文件starship preset也能输出预设。三、预设到底改了什么模块级符号映射详解与本文对应的完整预设文件位于 docs/public/presets/toml/plain-text-symbols.toml它用约 340 行的 TOML 覆盖了几十个模块。下面按类别还原这份映射并说明每个改动的作用。3.1 提示符外观与继续输入continuation_prompt . 多行继续提示符默认是两对括号/点组成的符号被替换为单个半角点.并用bright-black着色。这样在多行粘贴长命令时视觉上只出现普通字符不会因渲染不出特殊字形而错位。character模块提示符前的大符号全部替换为键盘可输入的字符[character] success_symbol error_symbol x vimcmd_symbol vimcmd_visual_symbol vimcmd_replace_symbol vimcmd_replace_one_symbol 命令成功绿色加粗命令失败x红色加粗与后续的 status 模块错误符号风格一致Vim 模式normal / visual / replace / replace_one统一使用仅通过不同颜色区分模式。由于character的符号不再依赖 Nerd Font在vi模式下也能用纯文本看出当前输入模式适合在仅支持 ASCII 的终端中使用。3.2 Git 与版本控制模块版本控制是提示符信息量最大的部分。此预设为 Git、Mercurial、Fossil、Pijul、Jujutsu 五类工具统一了纯文本标识[git_commit] tag_symbol tag [git_status] ahead behind diverged renamed r deleted x [git_branch] symbol git truncation_symbol ...git_branch分支名前的图标统一为git超长分支名的省略符号从图形字符改为三个点...git_status分支领先远端ahead用、落后用、分叉diverged用重命名计数用r、删除计数用x——这些紧凑 ASCII 标识在 diff 语义上直观且易于记忆git_commitcommit 哈希旁的 tag 标记改为文本tag。同类模块统一遵循相同风格[fossil_branch] symbol fossil truncation_symbol ... [hg_branch] symbol hg truncation_symbol ... [pijul_channel] symbol pijul truncation_symbol ... [jj_bookmark] symbol jj truncation_symbol ...这类symbol文字加尾随空格与默认的图形符号不同图形符号通常是只占一列、依靠字体对齐而 ASCII 文本后的尾随空格保证了与版本号之间有稳定间距无论终端渲染哪个字体都不会黏连。3.3 云平台、容器与网络环境模块当你在云环境或容器里工作时希望明确知道当前在哪个云/哪个上下文[aws] symbol aws [azure] symbol az [gcloud] symbol gcp [docker_context] symbol docker [kubernetes] symbol kubernetes [openstack] symbol openstack [container] symbol container [netns] symbol netns [nats] symbol nats 配合各模块自身的上下文名称提示符将呈现如docker production、aws prod这样的纯文本标签避免图形符号带来的歧义例如某些字库里 cloud 图标可能与垃圾桶图标混淆。3.4 语言运行时与构建工具这是预设覆盖模块最多的一类。语言运行时名称各不相同全部折叠为简短 ASCII 名[c] symbol C [cpp] symbol C [cobol] symbol cobol [conda] symbol conda [crystal] symbol cr [daml] symbol daml [dart] symbol dart [deno] symbol deno [dotnet] symbol .NET [elixir] symbol exs [elm] symbol elm [erlang] symbol erl [fennel] symbol fnl [fortran] symbol fortran [gleam] symbol gleam [golang] symbol go [haskell] symbol haskell [haxe] symbol hx [java] symbol java [julia] symbol jl [kotlin] symbol kt [lua] symbol lua [mojo] symbol mojo [nim] symbol nim [ocaml] symbol ml [odin] symbol odin [perl] symbol pl [php] symbol php [purescript] symbol purs [python] symbol py [raku] symbol raku [red] symbol red [rlang] symbol r [ruby] symbol rb [rust] symbol rs [scala] symbol scala [solidity] symbol solidity [swift] symbol swift [typst] symbol typst [vlang] symbol v # 仓库 vlang 模块的配套纯文本符号 [zig] symbol zig 包管理器、构建工具与运行时管理工具同理[buf] symbol buf [bun] symbol bun [cmake] symbol cmake [gradle] symbol gradle [guix_shell] symbol guix [helm] symbol helm [maven] symbol maven [meson] symbol meson [truncation_symbol] # meson 等模块同样使用 ... 截断 [nodejs] symbol nodejs [pixi] symbol pixi [pulumi] symbol pulumi [quarto] symbol quarto [spack] symbol spack [terraform] symbol terraform [vagrant] symbol vagrant [xmake] symbol xmake 其中meson也设置了truncation_symbol ...。注意vlang对应的v模块在预设仓库中名为[v]源码模块在 src/modules/vlang.rs对应默认符号的实现以本仓库实际模块表为准使用上述映射时请以预设 TOML 原文为基准核对模块段名。值得特别说明的是.NET模块它除了替换 symbol 外还覆写了整段format[dotnet] format via $symbol($version )(target $tfm ) symbol .NET 默认情况下该模块展示via .NET version (target tfm)。在纯文本方案里dotnet 的 Target Framework Moniker如net8.0本就由 ASCII 组成因此保留target段不会引入任何图形字符这条覆写是为了保证即使去掉 symbol 字形也能用via/target这类自然语言把信息说清楚。这也提示你覆写 format 往往比只换 symbol 更彻底。3.5 系统与状态类模块[directory] read_only ro [hostname] ssh_symbol ssh [jobs] symbol * [memory_usage] symbol memory [shlvl] symbol shlvl [sudo] symbol sudo directory目录为只读时显示ro后缀默认是一个锁形图标ro是 read-only 的惯用缩写hostname仅当通过 SSH 连接时才显示前缀ssh这延续了原模块只在 SSH 会话展示的语义jobs后台任务数用*表示shlvl、memory_usage、sudo分别用shlvl、memory、sudo等文本标签。battery模块则把四种电量状态与三种符号类型全部文本化[battery] full_symbol full charging_symbol charging discharging_symbol discharging unknown_symbol unknown empty_symbol empty status上一条命令的退出状态是排错时的高频模块预设对每种异常类型都给了明确的可读缩写[status] symbol x not_executable_symbol noexec not_found_symbol notfound sigint_symbol sigint signal_symbol sig一般失败红色加粗x非可执行文件退出noexec对应 126 号退出码语义命令不存在notfound对应 127被 SIGINT 中断sigint被其它信号终止sig加信号说明。相比默认图形化的✘/信号标识noexec、notfound、sigint这种全拼更利于脚本化解析和日志检索。3.6 操作系统发行版符号表os.symbolsos模块展示当前发行版图标。本预设将全部发行版映射为三到四个字符的 ASCII 缩写注意个别映射为规避拼写冲突而做了缩略例如 Arch →rch、EndeavourOS →ndev、Fedora →fed[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 从源码层面可以交叉验证这套映射的意义src/modules/os.rs#L332-L374 在维护os模块默认 symbol 的代码注释中明确列出docs/public/presets/toml/plain-text-symbols.toml与nerd-font-symbols.toml作为参考来源。也就是说官方在调整 OS 图形符号例如 Debian 的、Linux 的、macOS 的等默认 emoji时会同时保证这两套预设与默认表保持对应关系。这也意味着当你应用 plain-text 预设后os模块呈现的是这份与官方默认表同步维护的 ASCII 缩写表不存在某个发行版缺失的问题。四、预设的源码机制符号是如何进入二进制的理解 Plain Text Symbols 的背后机制有助于你在离线环境、或想 Fork 自定义时做出正确判断。从仓库源码可以得到三条结论预设文件即文档目录中的 TOML。主仓库把预设源文件放在docs/public/presets/toml/下每个预设一个文件本预设为plain-text-symbols.toml。Starship 的 CLI 使用include_str!将这些文件在编译期内嵌进二进制因此starship preset输出的是编译进当前版本的预设与仓库里对应 TOML 保持一致。相关机制的证据见 src/print.rs#L700-L703测试断言输出文件内容与内嵌 TOML 完全相等。文档页与预设文件一一对应。docs 目录下docs/presets/plain-text.md及所有语言翻译如 docs/pl-PL/presets/plain-text.md、docs/zh-CN/presets/plain-text.md在渲染时直接内嵌该 TOML 全文即文档中的 /public/presets/toml/plain-text-symbols.toml指令所以你在网页文档上看到的配置与命令输出的配置必然同源。OS 模块维护时以预设为基准。如 3.6 节所述模块源码注释直接把两套预设列为参考文件说明官方流程上默认符号改动必须同步预设这是一条可以放心依赖的一致性保证。五、手动配置、选择性应用与恢复默认5.1 下载 / 手动合并如果不想覆盖整个配置文件可以下载源 TOMLplain-text-symbols.toml把其中你需要的模块段复制粘贴到现有~/.config/starship.toml中。Starship 配置文件是增量合并的你完全可以在保留自己format、主题色的同时只把character、git_status、python这几段的 symbol 替换掉。5.2 与starship config/ 文档联动所有模块符号的完整可配置项默认值、取值类型、示例都收录在配置参考文档中。例如你想确认某一项在应用预设前的默认值、或想在此基础上微调某个 symbol可以# 打印当前计算出的完整配置含默认值 starship config # 临时查看某模块配置 starship config git_status修改后不需要重启 shell重新加载配置即可bashexec bashzshexec zsh或直接打开一个新终端。5.3 恢复默认要撤销预设把~/.config/starship.toml中由预设写入的段落清空或删除该文件后重新打开终端Starship 便会回退到内置默认符号。若你之前未备份原文件也可以先用starship config打印当前配置留存再通过上文命令重新生成。六、适用边界与注意事项对象是 symbol不改变模块逻辑。本预设只替换显示用的符号、截断符与少量format不关闭任何模块、不影响版本探测逻辑git_status的计数、status的退出码判定等行为与原版完全一致。纯 ASCII 也意味着更宽的占用。nodejs 、kubernetes 这类文本比单个 emoji 占的列更多若你同时追求极窄提示符可再结合No Runtime Versions隐藏运行时版本等预设相关合集见预设索引。与 Nerd Font 预设互为对照。仓库里还有面向 Nerd Font 字体的 Nerd Font Symbols 预设同一批模块那套预设替换成 Nerd Font 字形而本预设替换成 ASCII 文本。两者的作用域完全一致因此它也是排查某个模块符号为何没被替换时的对照物。版本前提。starship preset子命令、os.symbols全覆盖等能力以本仓库当前版本为准如使用发行版自带的旧版本 Starship请以starship preset --list的实际输出为准。另外用vlang这类模块段名时请先核对你所安装版本的starship config输出。总而言之Plain Text Symbols 是 Starship 为无 Unicode 环境准备的官方降级方案它以一份被源码内嵌、被模块维护流程引用的 TOML 为数据源通过starship preset plain-text-symbols -o ~/.config/starship.toml一条命令即可全局生效。理解了这份预设的映射逻辑与源码机制后你既能直接应用它也能以它为模板为自己的专用终端环境定制一套真正的纯 ASCII 提示符。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Starship Plain Text Symbols 预设全解析：把提示符改造成纯 ASCII 文本的完整配置指南
Starship Plain Text Symbols 预设全解析把提示符改造成纯 ASCII 文本的完整配置指南【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship导读Starship 默认在每个模块前展示 emoji / Nerd Font 图形符号但并非所有终端都支持 Unicode。本文以官方预设Plain Text Symbols配置文件名plain-text-symbols为核心系统讲解如何用一条starship preset命令把命令提示符中几乎所有模块符号替换为纯文本标识并深入到该预设的 TOML 源码、Starship 命令行的preset子命令实现与模块源码帮助你理解符号从哪来、怎么被替换、还能如何自定义彻底摆脱 Unicode 字体依赖。一、这个预设解决什么问题Starship 是一个跨 shell 的极简提示符默认情况下每个模块前面都会带一个图形符号icon。例如 Git 分支、语言运行时Python / Go / Rust 等、操作系统发行版都使用 emoji 或 Nerd Font 专有字形。这些字形正常渲染的前提是终端使用的字体包含对应 Unicode 码位Nerd Font 字形尤其依赖专用字体终端编码与操作系统能正确传递多字节字符。Plain Text Symbols 预设正是针对无法访问 Unicode 的环境设计的。所谓 plain text指的是把每个模块的 symbol 全部替换成 ASCII 可见字符加空格的形式例如 Go 的symbol go 、Rust 的symbol rs 、git 分支的symbol git 。这样即使终端只支持最基础的字库例如某些嵌入式串口终端、极简远程会话、无中文/无 emoji 字体渲染的环境提示符也能完整、对齐地显示。这套预设的官方定位可以看预设索引页与文档本体的说明This preset changes the symbols for each module into plain text. Great if you dont have access to Unicode.Plain Text Symbols 预设运行效果截图二、一键应用starship preset命令与输出行为原文档给出的唯一配置方式就是把内置预设输出到用户的配置文件starship preset plain-text-symbols -o ~/.config/starship.toml命令含义拆解plain-text-symbols预设名称是 Starship 二进制的内置 preset 之一-o, --output FILE把生成的 TOML 写到指定文件而不是打印到 stdout默认会写入~/.config/starship.toml这正是 Starship 在 Linux / macOS 上读取的主配置文件路径。关于这条命令的底层实现从源码src/main.rs中可以确认Starship 在 CLI 层专门定义了Preset子命令参见 src/main.rs#L102-L116支持三个参数参数含义取自 CLI 定义注释name要打印的预设名称value_enum只能传内置预设名-o, --output把预设输出到文件而非 stdout且与--list互斥-f, --force当输出文件已存在时强制覆盖依赖--output-l, --list列出所有可用预设名称也就是说若你的配置文件已经存在直接运行上面的命令可能会因文件已存在而失败此时需要追加--forcestarship preset plain-text-symbols -o ~/.config/starship.toml --force如果你只是想查看某个预设内容、或者把它合并进已有配置可以不加-o让预设打印到 stdout再重定向到文件starship preset plain-text-symbols starship preset plain-text-symbols ~/.config/starship.toml starship preset --listpreset命令的实际处理函数为print::preset_command见 src/print.rs#L530。同一文件中的单元测试如 src/print.rs#L682-L704验证了preset_command对全部预设取值都不会 panic并且输出到文件的内容与该预设的源 TOML 完全一致而输出文件已存在时强制覆盖的行为也由 src/print.rs#L707-L724 的测试用例覆盖。测试中比较的基准文件路径为../docs/public/presets/toml/nerd-font-symbols.toml说明文档目录下的 TOML 就是预设的真实数据源构建期通过include_str!内嵌进二进制——因此即使不联网、不携带该文件starship preset也能输出预设。三、预设到底改了什么模块级符号映射详解与本文对应的完整预设文件位于 docs/public/presets/toml/plain-text-symbols.toml它用约 340 行的 TOML 覆盖了几十个模块。下面按类别还原这份映射并说明每个改动的作用。3.1 提示符外观与继续输入continuation_prompt . 多行继续提示符默认是两对括号/点组成的符号被替换为单个半角点.并用bright-black着色。这样在多行粘贴长命令时视觉上只出现普通字符不会因渲染不出特殊字形而错位。character模块提示符前的大符号全部替换为键盘可输入的字符[character] success_symbol error_symbol x vimcmd_symbol vimcmd_visual_symbol vimcmd_replace_symbol vimcmd_replace_one_symbol 命令成功绿色加粗命令失败x红色加粗与后续的 status 模块错误符号风格一致Vim 模式normal / visual / replace / replace_one统一使用仅通过不同颜色区分模式。由于character的符号不再依赖 Nerd Font在vi模式下也能用纯文本看出当前输入模式适合在仅支持 ASCII 的终端中使用。3.2 Git 与版本控制模块版本控制是提示符信息量最大的部分。此预设为 Git、Mercurial、Fossil、Pijul、Jujutsu 五类工具统一了纯文本标识[git_commit] tag_symbol tag [git_status] ahead behind diverged renamed r deleted x [git_branch] symbol git truncation_symbol ...git_branch分支名前的图标统一为git超长分支名的省略符号从图形字符改为三个点...git_status分支领先远端ahead用、落后用、分叉diverged用重命名计数用r、删除计数用x——这些紧凑 ASCII 标识在 diff 语义上直观且易于记忆git_commitcommit 哈希旁的 tag 标记改为文本tag。同类模块统一遵循相同风格[fossil_branch] symbol fossil truncation_symbol ... [hg_branch] symbol hg truncation_symbol ... [pijul_channel] symbol pijul truncation_symbol ... [jj_bookmark] symbol jj truncation_symbol ...这类symbol文字加尾随空格与默认的图形符号不同图形符号通常是只占一列、依靠字体对齐而 ASCII 文本后的尾随空格保证了与版本号之间有稳定间距无论终端渲染哪个字体都不会黏连。3.3 云平台、容器与网络环境模块当你在云环境或容器里工作时希望明确知道当前在哪个云/哪个上下文[aws] symbol aws [azure] symbol az [gcloud] symbol gcp [docker_context] symbol docker [kubernetes] symbol kubernetes [openstack] symbol openstack [container] symbol container [netns] symbol netns [nats] symbol nats 配合各模块自身的上下文名称提示符将呈现如docker production、aws prod这样的纯文本标签避免图形符号带来的歧义例如某些字库里 cloud 图标可能与垃圾桶图标混淆。3.4 语言运行时与构建工具这是预设覆盖模块最多的一类。语言运行时名称各不相同全部折叠为简短 ASCII 名[c] symbol C [cpp] symbol C [cobol] symbol cobol [conda] symbol conda [crystal] symbol cr [daml] symbol daml [dart] symbol dart [deno] symbol deno [dotnet] symbol .NET [elixir] symbol exs [elm] symbol elm [erlang] symbol erl [fennel] symbol fnl [fortran] symbol fortran [gleam] symbol gleam [golang] symbol go [haskell] symbol haskell [haxe] symbol hx [java] symbol java [julia] symbol jl [kotlin] symbol kt [lua] symbol lua [mojo] symbol mojo [nim] symbol nim [ocaml] symbol ml [odin] symbol odin [perl] symbol pl [php] symbol php [purescript] symbol purs [python] symbol py [raku] symbol raku [red] symbol red [rlang] symbol r [ruby] symbol rb [rust] symbol rs [scala] symbol scala [solidity] symbol solidity [swift] symbol swift [typst] symbol typst [vlang] symbol v # 仓库 vlang 模块的配套纯文本符号 [zig] symbol zig 包管理器、构建工具与运行时管理工具同理[buf] symbol buf [bun] symbol bun [cmake] symbol cmake [gradle] symbol gradle [guix_shell] symbol guix [helm] symbol helm [maven] symbol maven [meson] symbol meson [truncation_symbol] # meson 等模块同样使用 ... 截断 [nodejs] symbol nodejs [pixi] symbol pixi [pulumi] symbol pulumi [quarto] symbol quarto [spack] symbol spack [terraform] symbol terraform [vagrant] symbol vagrant [xmake] symbol xmake 其中meson也设置了truncation_symbol ...。注意vlang对应的v模块在预设仓库中名为[v]源码模块在 src/modules/vlang.rs对应默认符号的实现以本仓库实际模块表为准使用上述映射时请以预设 TOML 原文为基准核对模块段名。值得特别说明的是.NET模块它除了替换 symbol 外还覆写了整段format[dotnet] format via $symbol($version )(target $tfm ) symbol .NET 默认情况下该模块展示via .NET version (target tfm)。在纯文本方案里dotnet 的 Target Framework Moniker如net8.0本就由 ASCII 组成因此保留target段不会引入任何图形字符这条覆写是为了保证即使去掉 symbol 字形也能用via/target这类自然语言把信息说清楚。这也提示你覆写 format 往往比只换 symbol 更彻底。3.5 系统与状态类模块[directory] read_only ro [hostname] ssh_symbol ssh [jobs] symbol * [memory_usage] symbol memory [shlvl] symbol shlvl [sudo] symbol sudo directory目录为只读时显示ro后缀默认是一个锁形图标ro是 read-only 的惯用缩写hostname仅当通过 SSH 连接时才显示前缀ssh这延续了原模块只在 SSH 会话展示的语义jobs后台任务数用*表示shlvl、memory_usage、sudo分别用shlvl、memory、sudo等文本标签。battery模块则把四种电量状态与三种符号类型全部文本化[battery] full_symbol full charging_symbol charging discharging_symbol discharging unknown_symbol unknown empty_symbol empty status上一条命令的退出状态是排错时的高频模块预设对每种异常类型都给了明确的可读缩写[status] symbol x not_executable_symbol noexec not_found_symbol notfound sigint_symbol sigint signal_symbol sig一般失败红色加粗x非可执行文件退出noexec对应 126 号退出码语义命令不存在notfound对应 127被 SIGINT 中断sigint被其它信号终止sig加信号说明。相比默认图形化的✘/信号标识noexec、notfound、sigint这种全拼更利于脚本化解析和日志检索。3.6 操作系统发行版符号表os.symbolsos模块展示当前发行版图标。本预设将全部发行版映射为三到四个字符的 ASCII 缩写注意个别映射为规避拼写冲突而做了缩略例如 Arch →rch、EndeavourOS →ndev、Fedora →fed[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 从源码层面可以交叉验证这套映射的意义src/modules/os.rs#L332-L374 在维护os模块默认 symbol 的代码注释中明确列出docs/public/presets/toml/plain-text-symbols.toml与nerd-font-symbols.toml作为参考来源。也就是说官方在调整 OS 图形符号例如 Debian 的、Linux 的、macOS 的等默认 emoji时会同时保证这两套预设与默认表保持对应关系。这也意味着当你应用 plain-text 预设后os模块呈现的是这份与官方默认表同步维护的 ASCII 缩写表不存在某个发行版缺失的问题。四、预设的源码机制符号是如何进入二进制的理解 Plain Text Symbols 的背后机制有助于你在离线环境、或想 Fork 自定义时做出正确判断。从仓库源码可以得到三条结论预设文件即文档目录中的 TOML。主仓库把预设源文件放在docs/public/presets/toml/下每个预设一个文件本预设为plain-text-symbols.toml。Starship 的 CLI 使用include_str!将这些文件在编译期内嵌进二进制因此starship preset输出的是编译进当前版本的预设与仓库里对应 TOML 保持一致。相关机制的证据见 src/print.rs#L700-L703测试断言输出文件内容与内嵌 TOML 完全相等。文档页与预设文件一一对应。docs 目录下docs/presets/plain-text.md及所有语言翻译如 docs/pl-PL/presets/plain-text.md、docs/zh-CN/presets/plain-text.md在渲染时直接内嵌该 TOML 全文即文档中的 /public/presets/toml/plain-text-symbols.toml指令所以你在网页文档上看到的配置与命令输出的配置必然同源。OS 模块维护时以预设为基准。如 3.6 节所述模块源码注释直接把两套预设列为参考文件说明官方流程上默认符号改动必须同步预设这是一条可以放心依赖的一致性保证。五、手动配置、选择性应用与恢复默认5.1 下载 / 手动合并如果不想覆盖整个配置文件可以下载源 TOMLplain-text-symbols.toml把其中你需要的模块段复制粘贴到现有~/.config/starship.toml中。Starship 配置文件是增量合并的你完全可以在保留自己format、主题色的同时只把character、git_status、python这几段的 symbol 替换掉。5.2 与starship config/ 文档联动所有模块符号的完整可配置项默认值、取值类型、示例都收录在配置参考文档中。例如你想确认某一项在应用预设前的默认值、或想在此基础上微调某个 symbol可以# 打印当前计算出的完整配置含默认值 starship config # 临时查看某模块配置 starship config git_status修改后不需要重启 shell重新加载配置即可bashexec bashzshexec zsh或直接打开一个新终端。5.3 恢复默认要撤销预设把~/.config/starship.toml中由预设写入的段落清空或删除该文件后重新打开终端Starship 便会回退到内置默认符号。若你之前未备份原文件也可以先用starship config打印当前配置留存再通过上文命令重新生成。六、适用边界与注意事项对象是 symbol不改变模块逻辑。本预设只替换显示用的符号、截断符与少量format不关闭任何模块、不影响版本探测逻辑git_status的计数、status的退出码判定等行为与原版完全一致。纯 ASCII 也意味着更宽的占用。nodejs 、kubernetes 这类文本比单个 emoji 占的列更多若你同时追求极窄提示符可再结合No Runtime Versions隐藏运行时版本等预设相关合集见预设索引。与 Nerd Font 预设互为对照。仓库里还有面向 Nerd Font 字体的 Nerd Font Symbols 预设同一批模块那套预设替换成 Nerd Font 字形而本预设替换成 ASCII 文本。两者的作用域完全一致因此它也是排查某个模块符号为何没被替换时的对照物。版本前提。starship preset子命令、os.symbols全覆盖等能力以本仓库当前版本为准如使用发行版自带的旧版本 Starship请以starship preset --list的实际输出为准。另外用vlang这类模块段名时请先核对你所安装版本的starship config输出。总而言之Plain Text Symbols 是 Starship 为无 Unicode 环境准备的官方降级方案它以一份被源码内嵌、被模块维护流程引用的 TOML 为数据源通过starship preset plain-text-symbols -o ~/.config/starship.toml一条命令即可全局生效。理解了这份预设的映射逻辑与源码机制后你既能直接应用它也能以它为模板为自己的专用终端环境定制一套真正的纯 ASCII 提示符。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考