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纯文本符号预设展开讲解如何将提示符中各个模块的图标与符号全部替换为普通 ASCII 纯文本从而在终端字体不支持 Unicode / Nerd Font 的环境下依然获得清晰、稳定的提示符展示。读完本文你将掌握该预设的安装命令、完整配置项说明、底层实现原理以及如何基于它进行二次定制。什么是 Plain Text Symbols 预设Starship 默认使用大量 Unicode 符号如分支图标、云服务图标、语言运行时图标等来增强提示符的视觉辨识度。这些符号依赖终端字体对 Unicode 与 Nerd Font 的支持一旦字体缺失就会渲染为方框tofu或乱码。Plain Text Symbols预设正是为此而生它把每个模块的符号统一替换为可读的纯文本例如git、python、rust仅保留极少数必要的样式控制符如颜色、加粗。根据 官方预设文档 的说明该预设将每个模块的符号改为纯文本非常适合无法访问 Unicode 的场景。典型适用场景包括使用老旧终端模拟器或嵌入式终端字体只支持 ASCIISSH 连接远程主机本地字体与远端渲染环境不一致需要将提示符内容复制到纯文本日志、CI 输出或文档中终端宽度有限希望以紧凑、无歧义的文本替代宽字符图标。完整的效果截图与配置源文件分别位于 plain-text-symbols.png 与 plain-text-symbols.toml。快速开始安装与应用该预设在已安装 Starship 的前提下只需一条命令即可将预设写入你的用户配置文件starship preset plain-text-symbols -o ~/.config/starship.toml该命令会将预设的完整 TOML 内容写入~/.config/starship.toml若文件已存在会被覆盖。从 src/main.rs 可以看到preset子命令支持以下参数参数说明name预设名称本处为plain-text-symbols可省略与--list二选一-o, --output path将预设写入指定文件而不是打印到标准输出-f, --force目标文件已存在时强制覆盖要求必须同时使用--output-l, --list列出所有可用的预设名称不生成任何文件如果你不确定当前版本包含哪些预设可以先执行starship preset --list输出中会出现plain-text-symbols及其余官方预设名称如nerd-font-symbols、no-nerd-font、bracketed-segments等。相关实现位于 src/print.rspreset_command根据名称取出预设内容通过write_file_atomic原子写入目标文件未指定--output时则直接打印到标准输出。验证是否生效重新打开一个终端或执行exec $SHELL重新加载提示符中的符号应全部变为纯文本。例如原本的 Git 分支符号会显示为gitPython 显示为py。你随时可以用以下命令查看当前生效的完整配置starship print-config预设配置内容全解该预设的核心是一份完整的 TOML 配置源文件见 plain-text-symbols.toml文件开头声明了 JSON Schema 引用$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 模式后普通命令模式为绿色可视模式为黄色替换模式为紫色。Git 相关模块[git_commit] tag_symbol tag [git_status] ahead behind diverged renamed r deleted xgit_commit.tag_symbolgit commit 模块中 tag 的标记默认是 Unicode 图钉符号这里改为tag。git_status本地上游比较与文件状态符号。领先上游用落后用分叉用重命名文件用r删除文件用x均为纯 ASCII。云服务模块[aws] symbol aws [azure] symbol az [gcloud] symbol gcp [openstack] symbol openstack [docker_context] symbol docker [kubernetes] symbol kubernetes AWS、Azure、GCP、OpenStack、Docker 上下文、Kubernetes 等云与容器模块的图标分别替换为对应的英文缩写 空格例如aws、az、gcp。系统与状态模块[battery] full_symbol full charging_symbol charging discharging_symbol discharging unknown_symbol unknown empty_symbol empty [hostname] ssh_symbol ssh [shlvl] symbol shlvl [jobs] symbol * [memory_usage] symbol memory [status] symbol x not_executable_symbol noexec not_found_symbol notfound sigint_symbol sigint signal_symbol sig [directory] read_only ro[battery]电池五种状态满电、充电、放电、未知、空分别用full、charging、discharging、unknown、empty表示。[hostname]SSH 会话前缀由默认符号改为ssh。[shlvl]shell 层级符号改为shlvl。[jobs]后台任务符号改为*。[memory_usage]内存占用符号改为memory。[status]上一条命令退出码非零时显示红色加粗的x非可执行文件显示noexec命令不存在显示notfoundSIGINT 中断显示sigint被信号终止显示sig。[directory]只读目录的标记由默认图标改为ro。语言与工具链模块symbol 替换该预设为几乎所有编程语言和构建工具模块替换了符号完整清单如下模块新符号模块新符号bufbufbunbuncCcppCcobolcobolcondacondacontainercontainercrystalcrcmakecmakedamldamldartdartdenodenodotnet.NETelixirexselmelmerlangerlfennelfnlfortranfortrangleamgleamgolanggogradlegradleguix_shellguixhaskellhaskellhaxehxhelmhelmjavajavajuliajlkotlinktlualuamavenmavennodejsnodejsmesonmesonmojomojonatsnatsnetnsnetnsnimnimnix_shellnixocamlmlodinodinopaopapackagepkgperlplphpphppixipixipulumipulumipurescriptpurspythonpyquartoquartorakurakuredredrlangrrubyrbrustrsscalascalaspackspacksoliditysoliditysudosudoswiftswifttypsttypstvagrantvagrantterraformterraformxmakexmakezigzig其中dotnet模块还额外重定义了format使用via连接词并显式展示目标框架target $tfm[dotnet] format via $symbol($version )(target $tfm ) symbol .NET 版本控制分支与截断符号[git_branch] symbol git truncation_symbol ...git_branch、fossil_branch、hg_branch、jj_bookmark、meson、pijul_channel等模块除了替换主符号外还把分支名过长时的截断符号统一设为...避免引入 Unicode 省略号字符。操作系统符号表os.symbols该预设对操作系统模块做了最彻底的替换在[os.symbols]表中为 60 余种操作系统/发行版定义了三个字符以内的 ASCII 缩写例如[os.symbols] Arch rch Debian deb Fedora fed Ubuntu ubnt Linux lnx Macos mac Windows win Alpine alp NixOS nix Unknown unk 完整映射覆盖 AIX、Android、CentOS、FreeBSD、Gentoo、Kali、Manjaro、Mint、openSUSE、Pop、Raspbian、Redox、Solus、Void、Zorin 等系统从源码结构看os.symbols的键与 os 模块 中支持的操作系统枚举一一对应任何受支持的系统都能在此预设下获得纯文本标识。源码视角preset 命令是如何工作的starship preset并不是简单地把一个写死的文件复制到用户目录其背后有完整的命令解析与写入链路命令定义在 src/main.rs 中Preset子命令声明了name、--output、--force、--list四个参数其中name的类型是print::Preset。名称枚举print::Preset在 src/print.rs 中实现ValueEnum通过shadow::get_preset_list()在编译期嵌入所有官方预设名称因此--list只能列出当前二进制内置的预设且不存在的名称会直接报错。内容读取与写入preset_command 调用shadow::get_preset_content(variant.0)取得预设 TOML 文本若指定了--output则通过write_file_atomic原子写入避免写入中断产生半截配置文件否则原样打印到 stdout——这意味着你可以用starship preset plain-text-symbols my-config.toml的方式把配置输出到任意路径。测试保障源码中附带了对该流程的单元测试src/print.rs覆盖列出预设非空、所有预设名都能正常输出不 panic、输出到文件以及对已存在文件使用--force覆盖等场景保证了预设命令的健壮性。手动应用与二次定制合并而非覆盖推荐-o ~/.config/starship.toml会整体覆盖已有配置。如果你已经在starship.toml中自定义了格式、颜色或自定义模块建议改为手动合并先输出预设内容到临时文件再把需要的symbol键合并进现有配置starship preset plain-text-symbols -o /tmp/plain-text-symbols.toml随后参考生成的/tmp/plain-text-symbols.toml把对应模块的symbol行复制到自己的配置文件中。注意本仓库是只读的请在你自己机器上的配置目录中完成该操作。只替换部分符号纯文本预设的价值在于全量替换但你完全可以只取其一部分。例如只想把 Git 分支和 Python 模块换成纯文本只需在配置中写[git_branch] symbol git [python] symbol py 所有symbol均为普通字符串语法与官方配置一致不依赖任何特殊字体即可生效。手动修改符号如果你对某个缩写不满意比如希望python显示为python3直接编辑配置文件中的对应键即可。由于该预设未改动模块的format除dotnet外符号替换对提示符布局的影响是局部的、可预期的。与其他预设的关系与回退在 预设总览 中可以看到Starship 的预设体系覆盖了不同字体与风格取向nerd-font-symbols使用 Nerd Font 符号需要安装 Nerd Font 字体no-nerd-font不使用 Nerd Font 符号但仍保留部分 Unicode 字符plain-text-symbols本文最彻底的 ASCII 化方案任何环境都能渲染。如果你在使用该预设后仍有个别符号显示异常可先用starship print-config查看实际生效值确认是否为自定义配置覆盖了预设键也可以使用starship preset --list切换回其他预设starship preset no-nerd-font -o ~/.config/starship.toml注意事项与最佳实践覆盖风险-o不带-f时若目标文件已存在preset_command会走原子写入路径从源码看write_file_atomic在文件存在时会报错并退出需显式加-f才能覆盖因此误覆盖的几率较低但合并式迁移仍是更稳妥的做法。格式兼容预设文件顶部带有$schema声明主流编辑器如 VS Code 配合 TOML 插件会自动启用 schema 校验编写或修改时能获得即时提示。风格一致性该预设把符号换成文本后提示符宽度会变长建议同时关注format中模块的排列必要时通过truncation_symbol ...控制分支名等长文本的截断长度预设已为相关模块内置该设置。适用前提本文所有命令与配置均以当前仓库Starship源码与官方预设文件为准不同版本的内置预设列表可能不同请以starship preset --list的实际输出为准。【免费下载链接】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 预设完全指南：无 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纯文本符号预设展开讲解如何将提示符中各个模块的图标与符号全部替换为普通 ASCII 纯文本从而在终端字体不支持 Unicode / Nerd Font 的环境下依然获得清晰、稳定的提示符展示。读完本文你将掌握该预设的安装命令、完整配置项说明、底层实现原理以及如何基于它进行二次定制。什么是 Plain Text Symbols 预设Starship 默认使用大量 Unicode 符号如分支图标、云服务图标、语言运行时图标等来增强提示符的视觉辨识度。这些符号依赖终端字体对 Unicode 与 Nerd Font 的支持一旦字体缺失就会渲染为方框tofu或乱码。Plain Text Symbols预设正是为此而生它把每个模块的符号统一替换为可读的纯文本例如git、python、rust仅保留极少数必要的样式控制符如颜色、加粗。根据 官方预设文档 的说明该预设将每个模块的符号改为纯文本非常适合无法访问 Unicode 的场景。典型适用场景包括使用老旧终端模拟器或嵌入式终端字体只支持 ASCIISSH 连接远程主机本地字体与远端渲染环境不一致需要将提示符内容复制到纯文本日志、CI 输出或文档中终端宽度有限希望以紧凑、无歧义的文本替代宽字符图标。完整的效果截图与配置源文件分别位于 plain-text-symbols.png 与 plain-text-symbols.toml。快速开始安装与应用该预设在已安装 Starship 的前提下只需一条命令即可将预设写入你的用户配置文件starship preset plain-text-symbols -o ~/.config/starship.toml该命令会将预设的完整 TOML 内容写入~/.config/starship.toml若文件已存在会被覆盖。从 src/main.rs 可以看到preset子命令支持以下参数参数说明name预设名称本处为plain-text-symbols可省略与--list二选一-o, --output path将预设写入指定文件而不是打印到标准输出-f, --force目标文件已存在时强制覆盖要求必须同时使用--output-l, --list列出所有可用的预设名称不生成任何文件如果你不确定当前版本包含哪些预设可以先执行starship preset --list输出中会出现plain-text-symbols及其余官方预设名称如nerd-font-symbols、no-nerd-font、bracketed-segments等。相关实现位于 src/print.rspreset_command根据名称取出预设内容通过write_file_atomic原子写入目标文件未指定--output时则直接打印到标准输出。验证是否生效重新打开一个终端或执行exec $SHELL重新加载提示符中的符号应全部变为纯文本。例如原本的 Git 分支符号会显示为gitPython 显示为py。你随时可以用以下命令查看当前生效的完整配置starship print-config预设配置内容全解该预设的核心是一份完整的 TOML 配置源文件见 plain-text-symbols.toml文件开头声明了 JSON Schema 引用$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 模式后普通命令模式为绿色可视模式为黄色替换模式为紫色。Git 相关模块[git_commit] tag_symbol tag [git_status] ahead behind diverged renamed r deleted xgit_commit.tag_symbolgit commit 模块中 tag 的标记默认是 Unicode 图钉符号这里改为tag。git_status本地上游比较与文件状态符号。领先上游用落后用分叉用重命名文件用r删除文件用x均为纯 ASCII。云服务模块[aws] symbol aws [azure] symbol az [gcloud] symbol gcp [openstack] symbol openstack [docker_context] symbol docker [kubernetes] symbol kubernetes AWS、Azure、GCP、OpenStack、Docker 上下文、Kubernetes 等云与容器模块的图标分别替换为对应的英文缩写 空格例如aws、az、gcp。系统与状态模块[battery] full_symbol full charging_symbol charging discharging_symbol discharging unknown_symbol unknown empty_symbol empty [hostname] ssh_symbol ssh [shlvl] symbol shlvl [jobs] symbol * [memory_usage] symbol memory [status] symbol x not_executable_symbol noexec not_found_symbol notfound sigint_symbol sigint signal_symbol sig [directory] read_only ro[battery]电池五种状态满电、充电、放电、未知、空分别用full、charging、discharging、unknown、empty表示。[hostname]SSH 会话前缀由默认符号改为ssh。[shlvl]shell 层级符号改为shlvl。[jobs]后台任务符号改为*。[memory_usage]内存占用符号改为memory。[status]上一条命令退出码非零时显示红色加粗的x非可执行文件显示noexec命令不存在显示notfoundSIGINT 中断显示sigint被信号终止显示sig。[directory]只读目录的标记由默认图标改为ro。语言与工具链模块symbol 替换该预设为几乎所有编程语言和构建工具模块替换了符号完整清单如下模块新符号模块新符号bufbufbunbuncCcppCcobolcobolcondacondacontainercontainercrystalcrcmakecmakedamldamldartdartdenodenodotnet.NETelixirexselmelmerlangerlfennelfnlfortranfortrangleamgleamgolanggogradlegradleguix_shellguixhaskellhaskellhaxehxhelmhelmjavajavajuliajlkotlinktlualuamavenmavennodejsnodejsmesonmesonmojomojonatsnatsnetnsnetnsnimnimnix_shellnixocamlmlodinodinopaopapackagepkgperlplphpphppixipixipulumipulumipurescriptpurspythonpyquartoquartorakurakuredredrlangrrubyrbrustrsscalascalaspackspacksoliditysoliditysudosudoswiftswifttypsttypstvagrantvagrantterraformterraformxmakexmakezigzig其中dotnet模块还额外重定义了format使用via连接词并显式展示目标框架target $tfm[dotnet] format via $symbol($version )(target $tfm ) symbol .NET 版本控制分支与截断符号[git_branch] symbol git truncation_symbol ...git_branch、fossil_branch、hg_branch、jj_bookmark、meson、pijul_channel等模块除了替换主符号外还把分支名过长时的截断符号统一设为...避免引入 Unicode 省略号字符。操作系统符号表os.symbols该预设对操作系统模块做了最彻底的替换在[os.symbols]表中为 60 余种操作系统/发行版定义了三个字符以内的 ASCII 缩写例如[os.symbols] Arch rch Debian deb Fedora fed Ubuntu ubnt Linux lnx Macos mac Windows win Alpine alp NixOS nix Unknown unk 完整映射覆盖 AIX、Android、CentOS、FreeBSD、Gentoo、Kali、Manjaro、Mint、openSUSE、Pop、Raspbian、Redox、Solus、Void、Zorin 等系统从源码结构看os.symbols的键与 os 模块 中支持的操作系统枚举一一对应任何受支持的系统都能在此预设下获得纯文本标识。源码视角preset 命令是如何工作的starship preset并不是简单地把一个写死的文件复制到用户目录其背后有完整的命令解析与写入链路命令定义在 src/main.rs 中Preset子命令声明了name、--output、--force、--list四个参数其中name的类型是print::Preset。名称枚举print::Preset在 src/print.rs 中实现ValueEnum通过shadow::get_preset_list()在编译期嵌入所有官方预设名称因此--list只能列出当前二进制内置的预设且不存在的名称会直接报错。内容读取与写入preset_command 调用shadow::get_preset_content(variant.0)取得预设 TOML 文本若指定了--output则通过write_file_atomic原子写入避免写入中断产生半截配置文件否则原样打印到 stdout——这意味着你可以用starship preset plain-text-symbols my-config.toml的方式把配置输出到任意路径。测试保障源码中附带了对该流程的单元测试src/print.rs覆盖列出预设非空、所有预设名都能正常输出不 panic、输出到文件以及对已存在文件使用--force覆盖等场景保证了预设命令的健壮性。手动应用与二次定制合并而非覆盖推荐-o ~/.config/starship.toml会整体覆盖已有配置。如果你已经在starship.toml中自定义了格式、颜色或自定义模块建议改为手动合并先输出预设内容到临时文件再把需要的symbol键合并进现有配置starship preset plain-text-symbols -o /tmp/plain-text-symbols.toml随后参考生成的/tmp/plain-text-symbols.toml把对应模块的symbol行复制到自己的配置文件中。注意本仓库是只读的请在你自己机器上的配置目录中完成该操作。只替换部分符号纯文本预设的价值在于全量替换但你完全可以只取其一部分。例如只想把 Git 分支和 Python 模块换成纯文本只需在配置中写[git_branch] symbol git [python] symbol py 所有symbol均为普通字符串语法与官方配置一致不依赖任何特殊字体即可生效。手动修改符号如果你对某个缩写不满意比如希望python显示为python3直接编辑配置文件中的对应键即可。由于该预设未改动模块的format除dotnet外符号替换对提示符布局的影响是局部的、可预期的。与其他预设的关系与回退在 预设总览 中可以看到Starship 的预设体系覆盖了不同字体与风格取向nerd-font-symbols使用 Nerd Font 符号需要安装 Nerd Font 字体no-nerd-font不使用 Nerd Font 符号但仍保留部分 Unicode 字符plain-text-symbols本文最彻底的 ASCII 化方案任何环境都能渲染。如果你在使用该预设后仍有个别符号显示异常可先用starship print-config查看实际生效值确认是否为自定义配置覆盖了预设键也可以使用starship preset --list切换回其他预设starship preset no-nerd-font -o ~/.config/starship.toml注意事项与最佳实践覆盖风险-o不带-f时若目标文件已存在preset_command会走原子写入路径从源码看write_file_atomic在文件存在时会报错并退出需显式加-f才能覆盖因此误覆盖的几率较低但合并式迁移仍是更稳妥的做法。格式兼容预设文件顶部带有$schema声明主流编辑器如 VS Code 配合 TOML 插件会自动启用 schema 校验编写或修改时能获得即时提示。风格一致性该预设把符号换成文本后提示符宽度会变长建议同时关注format中模块的排列必要时通过truncation_symbol ...控制分支名等长文本的截断长度预设已为相关模块内置该设置。适用前提本文所有命令与配置均以当前仓库Starship源码与官方预设文件为准不同版本的内置预设列表可能不同请以starship preset --list的实际输出为准。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考