Starship Plain Text Symbols 预设完全指南：在无 Unicode 环境下使用纯文本符号打造跨平台提示符

Starship Plain Text Symbols 预设完全指南：在无 Unicode 环境下使用纯文本符号打造跨平台提示符

【免费下载链接】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 / Nerd Font 字体的终端、远程服务器、CI 环境或老式终端模拟器中获得完全可读、无乱码的提示符。读完本文，你将掌握该预设的完整配置清单、安装与回退方法、以及其底层实现原理。

预设背景：为什么需要纯文本符号

Starship 默认提示符大量使用 Nerd Font 图标与 Unicode 特殊符号（如分支图标 、云图标 󰅟、版本标识等），这些符号需要终端与字体同时支持才能正确渲染。在以下场景中，默认符号会显示为方块、问号或乱码：

• 未安装 Nerd Font 的终端模拟器；
• 仅支持 ASCII 的远程服务器会话（如通过老式 SSH 客户端连接）；
• CI/CD 流水线中的日志输出；
• 无图形界面的精简环境。

Plain Text Symbols 预设正是为这类场景设计的：它把所有组件的符号改为纯文本（如git、py、rs），保留模块的排版结构、颜色与信息内容，只将符号替换为 ASCII 可见字符。其官方定义位于 docs/zh-CN/presets/plain-text.md，对应的完整配置模板保存在 docs/public/presets/toml/plain-text-symbols.toml。

快速上手：一条命令启用预设

启用该预设非常简单，只需执行 Starship 的preset子命令并输出到配置文件：

starship preset plain-text-symbols -o ~/.config/starship.toml

执行后，~/.config/starship.toml会被写入完整的纯文本符号配置，重新打开终端即可生效。

注意：-o参数会覆盖目标文件。如果你的starship.toml已有自定义配置，建议先备份，或将输出重定向后手动合并配置段。

预设子命令的更多用法

从 src/main.rs 的 CLI 定义可以看到，starship preset子命令还支持以下参数：

例如先查看有哪些预设、再预览纯文本预设的内容：

starship preset --list starship preset plain-text-symbols

不带-o时，预设内容会直接打印到标准输出，方便你检查或手动合并。其实现位于 src/print.rs：preset_command从内置资源读取预设内容，若指定了--output则通过原子写入函数落盘（配合--force可覆盖已有文件），否则写入 stdout；--list分支则遍历全部预设名逐行打印。

完整配置清单解析

该预设的完整配置保存在 docs/public/presets/toml/plain-text-symbols.toml，并引用官方 JSON Schema（$schema指向 Starship 的配置模式）。下面按功能分类逐一解析。

通用与字符模块

"$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 = "<"

• continuation_prompt：多行输入时第二行及以后的行首提示符，改为纯文本.并着亮黑色；
• [character]：普通提示符。成功时显示绿色粗体>，命令出错时显示红色粗体x；Vim 模式下的普通/可视/替换/单字符替换分别用绿色或紫色[<]标记，帮助你在 Vim 模式下直观区分当前编辑状态。

Git 相关模块

[git_commit] tag_symbol = " tag " [git_status] ahead = ">" behind = "<" diverged = "<>" renamed = "r" deleted = "x" [git_branch] symbol = "git " truncation_symbol = "..."

• [git_commit]将 tag 标识从图标改为文本tag；
• [git_status]用纯文本表达分支与工作区状态：领先上游>、落后<、分叉<>、重命名r、删除x（与character的错误符号一致）；
• [git_branch]将分支符号改为git，超长分支名截断符号统一为...。

云服务与虚拟化模块

[aws] symbol = "aws " [azure] symbol = "az " [gcloud] symbol = "gcp " [kubernetes] symbol = "kubernetes " [docker_context] symbol = "docker " [container] symbol = "container " [openstack] symbol = "openstack " [guix_shell] symbol = "guix " [nix_shell] symbol = "nix " [singularity] symbol = "singularity "

以上分别对应 AWS、Azure、Google Cloud、Kubernetes、Docker 上下文、容器环境、OpenStack、Guix Shell、Nix Shell 与 Singularity 模块，符号全部改为对应服务的英文缩写文本，避免图标在无字体环境下变成乱码。

语言运行时模块（部分示例）

[c] symbol = "C " [cpp] symbol = "C++ " [python] symbol = "py " [nodejs] symbol = "nodejs " [rust] symbol = "rs " [golang] symbol = "go " [java] symbol = "java " [ruby] symbol = "rb " [php] symbol = "php " [lua] symbol = "lua " [dotnet] format = "via $symbol($version )(target $tfm )" symbol = ".NET "

语言类模块统一将图标替换为语言名缩写（如C、C++、py、rs、go、rb），并保留尾部空格以维持排版。其中[dotnet]额外重写了format，显式拼接版本号$version与目标框架$tfm，在无图标环境下依然能展示完整的 .NET 环境信息。其余语言模块（如buf、bun、cobol、conda、crystal、cmake、daml、dart、deno、elixir、elm、erlang、fennel、fortran、gleam、gradle、haskell、haxe、helm、java、julia、kotlin、maven、mojo、nim、ocaml、odin、opa、perl、pixi、purescript、quarto、raku、red、rlang、scala、solidity、spack、swift、typst、v、zig等）均采用同样的策略，将 symbol 改为纯文本名称。

操作系统符号表[os.symbols]

该预设最庞大的部分是[os.symbols]表，覆盖了 60+ 个操作系统发行版。每个条目都是一个短文本标识，例如：

[os.symbols] Arch = "rch " Debian = "deb " Ubuntu = "ubnt " Fedora = "fed " CentOS = "cent " Alpine = "alp " NixOS = "nix " Macos = "mac " Windows = "win " Android = "andr " FreeBSD = "fbsd " OpenBSD = "obsd " Linux = "lnx " Unknown = "unk "

从源码 src/modules/os.rs 的注释可以看到，os模块在整理系统符号时明确参照了docs/public/presets/toml/plain-text-symbols.toml，说明该预设的os.symbols表就是 os 模块符号体系的事实标准。完整的键名列表（如AlmaLinux、Amazon、AOSC、Artix、EndeavourOS、Gentoo、Kali、Manjaro、Mint、Pop、Raspbian、RockyLinux、Void、Zorin等）可在 docs/public/presets/toml/plain-text-symbols.toml 中查看，便于对照自定义。

系统状态与工具模块

[battery] full_symbol = "full " charging_symbol = "charging " discharging_symbol = "discharging " unknown_symbol = "unknown " empty_symbol = "empty " [status] symbol = "x " not_executable_symbol = "noexec" not_found_symbol = "notfound" sigint_symbol = "sigint" signal_symbol = "sig" [jobs] symbol = "*" [memory_usage] symbol = "memory " [cmd_duration] # 默认即纯文本，无需改动

• [battery]将充满/充电/放电/未知/空电状态分别以英文单词呈现；
• [status]用x标记非零退出码，并用noexec、notfound、sigint、sig区分不可执行、命令不存在、中断信号与其他信号；
• [jobs]的后台任务数前缀改为*；
• [memory_usage]符号改为memory。

其他模块汇总

[directory]的只读目录标记改为ro；[hostname]的 SSH 会话符号改为ssh；[package]的包符号改为pkg；[shlvl]改为shlvl；[sudo]改为sudo；[vagrant]、[terraform]、[xmake]分别改为对应工具名；[fossil_branch]、[hg_branch]、[jj_bookmark]、[meson]、[pijul_channel]等带截断行为的模块统一使用truncation_symbol = "..."。[nats]、[netns]、[pulumi]、[raku]等也都有对应的纯文本 symbol。

与其他符号类预设的关系

Plain Text Symbols 是 Starship 官方符号类预设家族中的一员，同一批预设还包括（参见 docs/presets/README.md）：

• Nerd Font Symbols：将各模块符号替换为 Nerd Font 图标（docs/public/presets/toml/nerd-font-symbols.toml），需要终端安装 Nerd Font 才能正确显示；
• No Nerd Fonts：移除提示符中所有 Nerd Font 符号，但保留 Unicode 字符；
• Plain Text Symbols：本预设，进一步将所有符号（包括 Unicode 特殊字符）替换为纯 ASCII 文本，兼容性最强。

三者的定位差异在于：Nerd Font Symbols 追求视觉丰富度、No Nerd Fonts 兼容一般 Unicode 终端、而 Plain Text Symbols 面向最严苛的无 Unicode 环境。如果你希望在此基础上进一步隐藏运行时版本，可以叠加参考 no-runtimes 预设。

验证与回退

验证预设是否生效

starship preset plain-text-symbols -o ~/.config/starship.toml starship print-config

starship print-config会输出当前生效的配置（其 CLI 定义见 src/main.rs），检查其中各模块的symbol是否已变为纯文本即可。

恢复默认配置

rm ~/.config/starship.toml # 或先备份再删除

删除配置文件后 Starship 会回落到内置默认值；也可重新运行starship preset <其它预设>或手动编辑配置文件切换风格。

小结

Plain Text Symbols 预设用一套完整的纯 ASCII 符号体系替换了 Starship 的全部模块符号，覆盖字符提示符、Git 状态、云服务、60+ 操作系统、语言运行时、电池与退出码等几乎所有场景。对于无 Unicode 字体环境的用户，这是开箱即用、零乱码的最简方案；同时它的[os.symbols]表也成为 os 模块符号定义的参照标准。安装、验证与回退均只需一条命令，非常适合脚本化部署到服务器与 CI 环境。

【免费下载链接】starship☄🌌️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship