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