Starship提示符异常需检查~/.config/starship.toml配置：一、调整add_newline和prompt_order控制换行与模块顺序；二、用format字段定制各模块样式；三、通过custom模块注入动态命令输出；四、替换character符号为ASCII确保兼容；五、利用detect_files等条件实现上下文感知显示。

如果您已安装Starship但提示符显示不符合预期，则可能是由于~/.config/starship.toml中的格式字符串未正确配置。以下是调整提示符各组件显示样式与布局的具体操作步骤：

一、修改全局换行与分隔行为

Starship默认在每条命令提示符后插入空行，该行为由add_newline控制；同时可设置prompt_order决定模块渲染顺序，避免信息堆叠或错位。

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

2、添加或修改以下全局设置：

add_newline = false

prompt_order = ["username", "hostname", "directory", "git_branch", "character"]

3、保存并退出，执行source ~/.bashrc（或对应shell的初始化文件）使变更生效。

二、自定义单个模块的显示格式

每个模块（如git_branch、nodejs、directory）均支持format字段，使用TOML字符串语法组合变量、样式与静态文本，实现精确控制输出内容与外观。

1、定位目标模块节，例如编辑Git分支显示：

[git_branch]

2、设置format值以嵌入符号与颜色：

format = "⎇ [ $branch ](bold purple) "

3、若需仅在存在Git仓库时显示，添加条件开关：

disabled = false

when = "git rev-parse --is-inside-work-tree 2>/dev/null"

三、使用自定义命令注入动态内容

custom模块允许执行任意shell命令，并将输出嵌入提示符，适用于时间、天气、系统负载等实时信息。

1、在配置文件中新增custom模块节：

[custom.time]

2、指定命令与格式化规则：

command = "date +'%H:%M'"

format = "⏰ $output "

3、启用该模块并设定触发条件：

when = true

style = "fg:yellow"

四、禁用默认符号并替换为纯文本

某些终端或字体不支持Nerd Fonts私有字符（如分支图标⎇），可完全移除符号或替换为ASCII字符，确保跨环境一致性。

1、定位character模块：

[character]

2、替换success_symbol与error_symbol为ASCII字符：

success_symbol = "[>]"

error_symbol = "[×]"

3、关闭符号前缀的额外空格：

vicmd_symbol = "[:]"

buffered = false

五、基于上下文条件化显示模块

通过detect_files、detect_extensions或shell环境变量，可让模块仅在匹配特定项目结构或状态时出现，减少视觉干扰。

1、为Node.js项目配置专用模块：

[custom.node]

2、绑定检测逻辑与命令：

command = "node -v | cut -c1-6"

detect_files = ["package.json"]

format = "⬢ $output "

3、添加样式并限制作用域：

style = "fg:green"

when = """test -f package.json && node -v >/dev/null 2>&1"""