尧图网页设计 
Starship Plain Text Symbols 预设让提示符符号全部纯文本化的跨终端方案【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship导读Starship 默认提示符使用 Nerd Font 与 Unicode 图标来区分模块但在老旧终端、无字体回退的远程会话或纯 ASCII 环境下这些符号常显示为方块或乱码。官方内置的Plain Text Symbols预设法语文档见 docs/fr-FR/presets/plain-text.md英文版见 docs/presets/plain-text.md把每个模块的图标统一替换为易读的纯文本缩写并通过一条starship preset命令即可全局生效。阅读本文后你将掌握该预设的完整配置内容、底层命令机制涉及 src/main.rs 与 src/print.rs 的 CLI 实现以及如何在本机一键部署或手动合并该预设。一、这个预设解决什么问题Starship 为 aws、git、各类语言运行时等模块配了数十个特殊符号。这些符号依赖终端字体中包含的 Private Use Area 字符或 Nerd Font。当用户使用不带 Nerd Font 的系统默认字体终端通过 SSH、串口或网页版终端如远程 CI 日志输出提示符使用的字体渲染不支持某些字形渲染为空心方块□或问号时提示符的可读性会显著下降。Plain Text Symbols 预设的思路是不做删减只做翻译——所有模块依然显示只是把符号字段改成由可打印 ASCII 组成的文本如aws、git、py从而让任何终端都能无损显示。它在官方预设集合中的定位说明见 docs/presets/README.md#plain-text-symbols英文目录的对应小节社区称之为 Plain Text Symbols。二、一键启用starship preset用法与参数官方推荐的启用命令原文档配置小节为starship preset plain-text-symbols -o ~/.config/starship.toml该命令从二进制内嵌的预设内容中取出完整的plain-text-symbols配置并写入你的用户级配置文件。需要注意几点-o/--output把内容写到一个文件。如果省略-o配置会直接打印到 stdout方便你先查看再决定是否落盘。-f/--force目标文件已存在时会拒绝覆盖需显式加上-f才允许覆盖——因此对已有大量自定义配置的用户建议先备份~/.config/starship.toml再执行。-l/--list列出当前版本内置的全部预设名称可用于确认plain-text-symbols确实可用。写入后无需重载守护进程新开一个终端会话即可看到纯文本风格的提示符。以上参数行为可以直接在源码中找到依据。CLI 定义位于 src/main.rs#L102-L116name是value_enum枚举值来自二进制内置的预设列表output与list互斥force必须配合output使用命令分派见 src/main.rs#L262。随后 src/print.rs#L530-L546 中的preset_command决定输出方向若指定-l打印 src/print.rs#L548-L555 生成的预设名称清单否则通过shadow::get_preset_content取出内嵌 TOML 文本若给出-o调用crate::utils::write_file_atomic原子写入目标路径出错时以非零码退出。原子写入的实现位于 src/utils/mod.rs#L93-L97其文档注释明确写着Only overwrites existing files ifforceis true仅当force为 true 时才覆盖已有文件。该函数先在目标同目录写临时文件再原位替换避免中途断电留下半截配置同时保留了目标文件原有的 Unix 权限位。三、预设内容全景纯文本符号映射表该预设的完整 TOML 位于 docs/public/presets/toml/plain-text-symbols.toml以下是按功能分组的全部变更。任何模块只要没有在这里出现就表示其默认符号保持不变因此这是一个增量覆盖型预设。3.1 提示符全局与字符模块$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 首行$schema声明配置遵循官方 JSON Schema对应仓库中的 docs/public/config-schema.json便于编辑器补全与校验。continuation_prompt续行提示符从默认的波浪线改为灰色圆点.。character模块是提示符的脸面普通命令成功时显示绿色、失败时显示红色xVim 命令/可视/替换模式下统一使用并在颜色上区分绿/黄/紫替换类模式保留紫色以示一致。3.2 状态与系统信息模块[status] symbol x not_executable_symbol noexec not_found_symbol notfound sigint_symbol sigint signal_symbol sig [jobs] symbol * [sudo] symbol sudo [hostname] ssh_symbol ssh [shlvl] symbol shlvl [directory] read_only rostatus模块区分了各类失败原因常规错误仍用红色x前缀文件不可执行、命令不存在、Ctrl-CSIGINT与收到其他信号时分别输出noexec、notfound、sigint和sig把原先难以辨认的信号图标变成明确文字。jobs后台任务计数前缀改为*sudo检测到 sudo 凭据显示sudo远程 SSH 会话的hostname前缀为sshshell 层级计数用shlvl文字只读目录在directory中追加灰色ro后缀。3.3 版本控制模块[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是最容易被字符集影响的模块之一领先远程ahead、落后behind、分叉diverged、重命名renamed、删除deleted分别替换为、、、r、x同时保持原有的颜色样式不丢失。git_branch分支符号从 Nerd Font 分支图标换成git超长分支名的截断符统一为...。同属分布式的其它版本控制模块也做了对应简化fossil_branch前缀fossil、hg_branch前缀hg、jj_bookmark前缀jj、pijul_channel前缀pijul并都把truncation_symbol设为...。3.4 云端、容器与虚拟化环境[aws] symbol aws [azure] symbol az [gcloud] symbol gcp [docker_context] symbol docker [kubernetes] symbol kubernetes [container] symbol container [nats] symbol nats [netns] symbol netns [openstack] symbol openstack [vagrant] symbol vagrant [conda] symbol conda [guix_shell] symbol guix [nix_shell] symbol nix [spack] symbol spack [pixi] symbol pixi 云厂商徽标、容器与虚拟化工具的专属符号大多来自 Nerd Font 的厂商图标区在此全部降级为供应商缩写文本AWS→aws、Azure→az、GCP→gcp、Docker→docker、K8s→kubernetes、Vagrant→vagrant等。这样即使没有加载任何图标字体也能一眼认出当前所处的云/容器上下文。3.5 语言与构建工具运行时以下语言/运行时模块全部只改写symbol字段样式与格式逻辑不变[buf] symbol buf [bun] symbol bun [c] symbol C [cpp] symbol C [cobol] symbol cobol [cmake] symbol cmake [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 [gradle] symbol gradle [haskell] symbol haskell [haxe] symbol hx [helm] symbol helm [java] symbol java [julia] symbol jl [kotlin] symbol kt [lua] symbol lua [maven] symbol maven [meson] symbol meson [mojo] symbol mojo [nim] symbol nim [nodejs] symbol nodejs [ocaml] symbol ml [odin] symbol odin [opa] symbol opa [perl] symbol pl [php] symbol php [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 [solidity] symbol solidity [swift] symbol swift [terraform] symbol terraform [typst] symbol typst [xmake] symbol xmake [zig] symbol zig 替换规则很有规律要么直接采用生态常用缩写py/rb/rs/go/kt/jl/pl要么使用可读的名称haskell/java/nodejs。其中 c、cpp 的符号带空格写作C与C是为了与后续版本号之间保持一个自然空格。值得单独说明的是dotnet模块它除了把符号改为.NET还覆盖了整段 format[dotnet] format via $symbol($version )(target $tfm ) symbol .NET 默认 dotnet 格式在找不到 SDK 时会输出空图标$symbol在未检测到工具链时留空。改成显式via ...格式并结合该预设的行为可避免空图标占位造成的对齐错乱——这与预设集合中另一个 No Empty Icons 预设见 docs/presets/no-empty-icons.md关注的问题属于同类。其余未被改写的运行时模块例如zig之外的 elixir、lua 等仍在 TOML 中被显式声明symbol其作用是把默认的 Nerd Font 字形彻底排除出你的提示符确保零 Unicode 依赖。3.6 操作系统标识模块最后一大块是针对 os 模块的os.symbols映射。Starship 的 os 模块会读取/etc/os-release等系统信息并把发行版名匹配到这里的键例如[os.symbols] Arch rch Debian deb Fedora fed Ubuntu ubnt Alpine alp Linux lnx Macos mac Windows win Unknown unk 完整映射覆盖 60 余个系统标识从 AIX、Android 到 Zorin这里仅摘录几条常见项全部键值对可在 docs/public/presets/toml/plain-text-symbols.toml 的[os.symbols]小节中查看。可以看到它们统一采用~3 个字符 空格的紧凑格式即使只有几列宽的终端也能完整放下。四、底层机制预设如何内嵌进二进制Plain Text Symbols 预设文件.toml在构建期被编译进 Starship 二进制。运行时通过Preset枚举引用它们src/print.rs#L517-L528 定义pub struct Preset(pub static str)并实现 clap 的ValueEnum其合法取值由shadow::get_preset_list()提供——这意味着starship preset的name参数在编译期就固定不会因磁盘文件缺失而失效。取配置内容用shadow::get_preset_content(...)它是一个编译期把预设 TOML 文本打包进二进制、运行时按名字取回的函数这就是 TOML 中$schema以绝对 URL 形式存在的原因——它只是编辑器补全提示不会在运行期发起网络请求。仓库对应的测试覆盖了三条主路径见 src/print.rs#L683-L720合法输入不 panic、-o能真正写出文件、目标已存在时配合force才覆盖——你可以通过阅读这些用例理解预期行为。这一资源内嵌 ValueEnum 白名单的设计保证了在任何离线或最小化安装的机器上starship preset plain-text-symbols都能立即工作无需从网络下载任何字体或配置。五、进阶手动合并、验证与回滚已有大量自定义配置时starship preset ... -f -o会整体覆盖starship.toml。更稳妥的做法是先不落盘直接看输出starship preset plain-text-symbols省略-o打印到 stdout从输出中挑选你需要的模块段落例如只想要git_status、character与os.symbols手工合并进现有文件用starship print-config校验解析结果、用starship prompt在任意目录下试渲染详见 docs/config/README.md 与 docs/advanced-config/README.md不满意时恢复备份或再次运行starship preset default -o ~/.config/starship.toml回到出厂默认主题。验证生效的小技巧如果终端曾渲染出□/?执行上述预设后git status前的、失败命令前的红色x、Python 项目前的py应全部以可打印字符呈现不再出现任何私有区字形。六、适用范围与已知前提该预设只改变符号symbol/图标不隐藏模块也不改变版本检测逻辑因此适用于任何官方支持的 shellbash/zsh/fish/PowerShell 等初始化脚本见 src/init 目录。若你的终端本身支持 Unicode 但字体缺字形也可使用姊妹预设No Nerd Fontdocs/presets/no-nerd-font.md——它在纯 Unicode 范围内换用常见字形而非全 ASCII两者按你实际终端能力二选一。纯文本预设会牺牲一定的视觉辨识度图标被文字替代、提示符变宽这是换取最大终端兼容性的必然取舍。结语Plain Text Symbols 预设是 Starship infinitely customizable 理念的最小化实践不依赖任何外部字体只用一份约 340 行的 TOML就完成了对云、容器、版本控制、语言运行时、操作系统等数十个模块符号的系统性替换。理解其 TOML 结构后你完全可以仿照它定制属于自己的符号集——例如只替换团队常用的几个模块或换成中文/日文等本地化缩写。掌握starship preset的-o、-f、-l参数与原子写入语义也就掌握了 Starship 配置分发的标准姿势。【免费下载链接】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 预设：让提示符符号全部“纯文本化“的跨终端方案
Starship Plain Text Symbols 预设让提示符符号全部纯文本化的跨终端方案【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship导读Starship 默认提示符使用 Nerd Font 与 Unicode 图标来区分模块但在老旧终端、无字体回退的远程会话或纯 ASCII 环境下这些符号常显示为方块或乱码。官方内置的Plain Text Symbols预设法语文档见 docs/fr-FR/presets/plain-text.md英文版见 docs/presets/plain-text.md把每个模块的图标统一替换为易读的纯文本缩写并通过一条starship preset命令即可全局生效。阅读本文后你将掌握该预设的完整配置内容、底层命令机制涉及 src/main.rs 与 src/print.rs 的 CLI 实现以及如何在本机一键部署或手动合并该预设。一、这个预设解决什么问题Starship 为 aws、git、各类语言运行时等模块配了数十个特殊符号。这些符号依赖终端字体中包含的 Private Use Area 字符或 Nerd Font。当用户使用不带 Nerd Font 的系统默认字体终端通过 SSH、串口或网页版终端如远程 CI 日志输出提示符使用的字体渲染不支持某些字形渲染为空心方块□或问号时提示符的可读性会显著下降。Plain Text Symbols 预设的思路是不做删减只做翻译——所有模块依然显示只是把符号字段改成由可打印 ASCII 组成的文本如aws、git、py从而让任何终端都能无损显示。它在官方预设集合中的定位说明见 docs/presets/README.md#plain-text-symbols英文目录的对应小节社区称之为 Plain Text Symbols。二、一键启用starship preset用法与参数官方推荐的启用命令原文档配置小节为starship preset plain-text-symbols -o ~/.config/starship.toml该命令从二进制内嵌的预设内容中取出完整的plain-text-symbols配置并写入你的用户级配置文件。需要注意几点-o/--output把内容写到一个文件。如果省略-o配置会直接打印到 stdout方便你先查看再决定是否落盘。-f/--force目标文件已存在时会拒绝覆盖需显式加上-f才允许覆盖——因此对已有大量自定义配置的用户建议先备份~/.config/starship.toml再执行。-l/--list列出当前版本内置的全部预设名称可用于确认plain-text-symbols确实可用。写入后无需重载守护进程新开一个终端会话即可看到纯文本风格的提示符。以上参数行为可以直接在源码中找到依据。CLI 定义位于 src/main.rs#L102-L116name是value_enum枚举值来自二进制内置的预设列表output与list互斥force必须配合output使用命令分派见 src/main.rs#L262。随后 src/print.rs#L530-L546 中的preset_command决定输出方向若指定-l打印 src/print.rs#L548-L555 生成的预设名称清单否则通过shadow::get_preset_content取出内嵌 TOML 文本若给出-o调用crate::utils::write_file_atomic原子写入目标路径出错时以非零码退出。原子写入的实现位于 src/utils/mod.rs#L93-L97其文档注释明确写着Only overwrites existing files ifforceis true仅当force为 true 时才覆盖已有文件。该函数先在目标同目录写临时文件再原位替换避免中途断电留下半截配置同时保留了目标文件原有的 Unix 权限位。三、预设内容全景纯文本符号映射表该预设的完整 TOML 位于 docs/public/presets/toml/plain-text-symbols.toml以下是按功能分组的全部变更。任何模块只要没有在这里出现就表示其默认符号保持不变因此这是一个增量覆盖型预设。3.1 提示符全局与字符模块$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 首行$schema声明配置遵循官方 JSON Schema对应仓库中的 docs/public/config-schema.json便于编辑器补全与校验。continuation_prompt续行提示符从默认的波浪线改为灰色圆点.。character模块是提示符的脸面普通命令成功时显示绿色、失败时显示红色xVim 命令/可视/替换模式下统一使用并在颜色上区分绿/黄/紫替换类模式保留紫色以示一致。3.2 状态与系统信息模块[status] symbol x not_executable_symbol noexec not_found_symbol notfound sigint_symbol sigint signal_symbol sig [jobs] symbol * [sudo] symbol sudo [hostname] ssh_symbol ssh [shlvl] symbol shlvl [directory] read_only rostatus模块区分了各类失败原因常规错误仍用红色x前缀文件不可执行、命令不存在、Ctrl-CSIGINT与收到其他信号时分别输出noexec、notfound、sigint和sig把原先难以辨认的信号图标变成明确文字。jobs后台任务计数前缀改为*sudo检测到 sudo 凭据显示sudo远程 SSH 会话的hostname前缀为sshshell 层级计数用shlvl文字只读目录在directory中追加灰色ro后缀。3.3 版本控制模块[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是最容易被字符集影响的模块之一领先远程ahead、落后behind、分叉diverged、重命名renamed、删除deleted分别替换为、、、r、x同时保持原有的颜色样式不丢失。git_branch分支符号从 Nerd Font 分支图标换成git超长分支名的截断符统一为...。同属分布式的其它版本控制模块也做了对应简化fossil_branch前缀fossil、hg_branch前缀hg、jj_bookmark前缀jj、pijul_channel前缀pijul并都把truncation_symbol设为...。3.4 云端、容器与虚拟化环境[aws] symbol aws [azure] symbol az [gcloud] symbol gcp [docker_context] symbol docker [kubernetes] symbol kubernetes [container] symbol container [nats] symbol nats [netns] symbol netns [openstack] symbol openstack [vagrant] symbol vagrant [conda] symbol conda [guix_shell] symbol guix [nix_shell] symbol nix [spack] symbol spack [pixi] symbol pixi 云厂商徽标、容器与虚拟化工具的专属符号大多来自 Nerd Font 的厂商图标区在此全部降级为供应商缩写文本AWS→aws、Azure→az、GCP→gcp、Docker→docker、K8s→kubernetes、Vagrant→vagrant等。这样即使没有加载任何图标字体也能一眼认出当前所处的云/容器上下文。3.5 语言与构建工具运行时以下语言/运行时模块全部只改写symbol字段样式与格式逻辑不变[buf] symbol buf [bun] symbol bun [c] symbol C [cpp] symbol C [cobol] symbol cobol [cmake] symbol cmake [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 [gradle] symbol gradle [haskell] symbol haskell [haxe] symbol hx [helm] symbol helm [java] symbol java [julia] symbol jl [kotlin] symbol kt [lua] symbol lua [maven] symbol maven [meson] symbol meson [mojo] symbol mojo [nim] symbol nim [nodejs] symbol nodejs [ocaml] symbol ml [odin] symbol odin [opa] symbol opa [perl] symbol pl [php] symbol php [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 [solidity] symbol solidity [swift] symbol swift [terraform] symbol terraform [typst] symbol typst [xmake] symbol xmake [zig] symbol zig 替换规则很有规律要么直接采用生态常用缩写py/rb/rs/go/kt/jl/pl要么使用可读的名称haskell/java/nodejs。其中 c、cpp 的符号带空格写作C与C是为了与后续版本号之间保持一个自然空格。值得单独说明的是dotnet模块它除了把符号改为.NET还覆盖了整段 format[dotnet] format via $symbol($version )(target $tfm ) symbol .NET 默认 dotnet 格式在找不到 SDK 时会输出空图标$symbol在未检测到工具链时留空。改成显式via ...格式并结合该预设的行为可避免空图标占位造成的对齐错乱——这与预设集合中另一个 No Empty Icons 预设见 docs/presets/no-empty-icons.md关注的问题属于同类。其余未被改写的运行时模块例如zig之外的 elixir、lua 等仍在 TOML 中被显式声明symbol其作用是把默认的 Nerd Font 字形彻底排除出你的提示符确保零 Unicode 依赖。3.6 操作系统标识模块最后一大块是针对 os 模块的os.symbols映射。Starship 的 os 模块会读取/etc/os-release等系统信息并把发行版名匹配到这里的键例如[os.symbols] Arch rch Debian deb Fedora fed Ubuntu ubnt Alpine alp Linux lnx Macos mac Windows win Unknown unk 完整映射覆盖 60 余个系统标识从 AIX、Android 到 Zorin这里仅摘录几条常见项全部键值对可在 docs/public/presets/toml/plain-text-symbols.toml 的[os.symbols]小节中查看。可以看到它们统一采用~3 个字符 空格的紧凑格式即使只有几列宽的终端也能完整放下。四、底层机制预设如何内嵌进二进制Plain Text Symbols 预设文件.toml在构建期被编译进 Starship 二进制。运行时通过Preset枚举引用它们src/print.rs#L517-L528 定义pub struct Preset(pub static str)并实现 clap 的ValueEnum其合法取值由shadow::get_preset_list()提供——这意味着starship preset的name参数在编译期就固定不会因磁盘文件缺失而失效。取配置内容用shadow::get_preset_content(...)它是一个编译期把预设 TOML 文本打包进二进制、运行时按名字取回的函数这就是 TOML 中$schema以绝对 URL 形式存在的原因——它只是编辑器补全提示不会在运行期发起网络请求。仓库对应的测试覆盖了三条主路径见 src/print.rs#L683-L720合法输入不 panic、-o能真正写出文件、目标已存在时配合force才覆盖——你可以通过阅读这些用例理解预期行为。这一资源内嵌 ValueEnum 白名单的设计保证了在任何离线或最小化安装的机器上starship preset plain-text-symbols都能立即工作无需从网络下载任何字体或配置。五、进阶手动合并、验证与回滚已有大量自定义配置时starship preset ... -f -o会整体覆盖starship.toml。更稳妥的做法是先不落盘直接看输出starship preset plain-text-symbols省略-o打印到 stdout从输出中挑选你需要的模块段落例如只想要git_status、character与os.symbols手工合并进现有文件用starship print-config校验解析结果、用starship prompt在任意目录下试渲染详见 docs/config/README.md 与 docs/advanced-config/README.md不满意时恢复备份或再次运行starship preset default -o ~/.config/starship.toml回到出厂默认主题。验证生效的小技巧如果终端曾渲染出□/?执行上述预设后git status前的、失败命令前的红色x、Python 项目前的py应全部以可打印字符呈现不再出现任何私有区字形。六、适用范围与已知前提该预设只改变符号symbol/图标不隐藏模块也不改变版本检测逻辑因此适用于任何官方支持的 shellbash/zsh/fish/PowerShell 等初始化脚本见 src/init 目录。若你的终端本身支持 Unicode 但字体缺字形也可使用姊妹预设No Nerd Fontdocs/presets/no-nerd-font.md——它在纯 Unicode 范围内换用常见字形而非全 ASCII两者按你实际终端能力二选一。纯文本预设会牺牲一定的视觉辨识度图标被文字替代、提示符变宽这是换取最大终端兼容性的必然取舍。结语Plain Text Symbols 预设是 Starship infinitely customizable 理念的最小化实践不依赖任何外部字体只用一份约 340 行的 TOML就完成了对云、容器、版本控制、语言运行时、操作系统等数十个模块符号的系统性替换。理解其 TOML 结构后你完全可以仿照它定制属于自己的符号集——例如只替换团队常用的几个模块或换成中文/日文等本地化缩写。掌握starship preset的-o、-f、-l参数与原子写入语义也就掌握了 Starship 配置分发的标准姿势。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考