StarshipPlainText预设使用教程

Starship 的 Plain Text 预设专为极致兼容性与终端普适性而生——它一键生成纯 ASCII 提示符配置，彻底移除所有 Unicode 图标和字体依赖，让提示符在 Windows Terminal、Linux tty、嵌入式串口甚至老旧终端中都能清晰、稳定、无乱码地运行；只需一条命令生成配置、一次重载 Shell，即可获得语义明确、结构简洁、零字体配置负担的极简提示符体验。

如果您希望在终端中使用纯文本符号替代 Unicode 或 Nerd Font 图标，以确保最大兼容性与可读性，则 Starship 的 Plain Text 预设可直接满足该需求。以下是应用该预设的具体步骤：

一、执行 preset 命令生成配置

Plain Text 预设通过 starship CLI 工具一键生成标准 TOML 配置，覆盖默认提示符中所有图标与富文本样式，仅保留 ASCII 字符与括号结构。

1、在终端中运行以下命令：
starship preset plain-text -o ~/.config/starship.toml

2、确认命令执行成功，输出中应包含 Writing preset to ~/.config/starship.toml 提示。

3、检查目标路径是否存在该文件：
ls -l ~/.config/starship.toml

二、验证字体无关性

该预设不依赖任何特殊字体，因此无需安装 Nerd Font 或调整终端字体设置，适用于所有基础终端环境（如 Windows Terminal 默认字体、Linux tty、嵌入式串口终端等）。

1、关闭当前终端窗口，避免缓存影响。

2、新开终端并执行：
starship prompt

3、观察输出是否仅含方括号、ASCII 符号（如 [git:main]、[~/project]、->）且无乱码或空格错位。

三、手动校验关键模块配置

Plain Text 预设会显式禁用所有图标字段，并将 symbol 参数替换为纯文本字符串，确保各模块语义清晰、无视觉歧义。

1、打开配置文件：
cat ~/.config/starship.toml

2、查找 [character] 模块，确认存在如下内容：
success_symbol = "-> "
error_symbol = "!> "

3、查找 [git_branch] 模块，确认 symbol 字段值为 "git:" 而非 Unicode 图标。

4、查找 [directory] 模块，确认 truncation_symbol 字段为空字符串或 ASCII 点号（如 "…" 已被替换为 "..."）。

四、强制重载配置生效

Shell 初始化脚本需重新评估以加载新配置，否则仍可能沿用旧提示符逻辑。

1、根据所用 Shell 执行对应重载命令：
Bash 用户运行：source ~/.bashrc
Zsh 用户运行：source ~/.zshrc
Fish 用户运行：source ~/.config/fish/config.fish

2、执行 echo $STARSHIP_CONFIG，确认其值为空或指向 ~/.config/starship.toml。

3、输入任意命令（如 ls），观察提示符是否立即呈现纯文本格式。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~