需手动启用starship的time模块并配置：一、确认starship已安装且shell完成初始化；二、在~/.config/starship.toml中启用[time]模块并设format、time_format等；三、可用[custom.time_ms]调用date实现毫秒级时间；四、通过[custom.time_conditional]按目录或环境变量条件显示时间。
如果您希望在Starship提示符中实时显示当前系统时间，但默认配置未启用时间模块，则需手动启用并定制其格式与行为。以下是实现时间戳显示的具体操作步骤：
一、确认Starship已安装并完成Shell初始化
时间模块依赖Starship核心运行环境正常加载，若Starship未初始化或Shell配置未生效，所有模块（包括time）均不会渲染。必须确保Starship可执行且已注入当前Shell。
1、运行 starship --version 验证Starship是否已成功安装并加入PATH。
2、执行 echo $SHELL 或 ps -p $$ 确认当前Shell类型（如bash、zsh、fish或PowerShell）。
3、打开对应Shell配置文件（例如zsh为 ~/.zshrc，PowerShell为 $PROFILE），检查是否存在初始化语句，如 eval "$(starship init zsh)" 或 Invoke-Expression (&starship init powershell)。
4、若缺失初始化行，请添加后执行 source ~/.zshrc（或对应命令）重新加载配置。
二、启用内置time模块并配置显示格式
Starship提供原生 time 模块，用于在提示符中插入动态时间戳。该模块默认禁用，需在 ~/.config/starship.toml 中显式声明并设置格式字符串、时区与更新间隔。
1、创建配置目录及文件：mkdir -p ~/.config && touch ~/.config/starship.toml。
2、使用文本编辑器打开该文件，写入以下内容：
[time]
format = "? [$time](bold yellow)"
time_format = "%H:%M:%S"
disabled = false
utc_time_offset = "+08:00"
3、保存后，在新终端窗口中验证：时间模块应立即出现在提示符左侧或右侧（取决于prompt_order配置）。
三、通过自定义模块实现高精度时间显示
当内置time模块无法满足特定需求（如毫秒级精度、多时区并列、或仅在特定目录下激活），可利用Starship的custom模块机制，调用系统命令动态生成时间字符串。
1、在 ~/.config/starship.toml 文件末尾追加以下段落：
[custom.time_ms]
command = 'date "+%H:%M:%S.%3N" '
when = '''true'''
format = "⏱️ [$output]($style)"
style = "bold cyan"
2、确保系统支持 %3N（GNU date），macOS用户需先安装coreutils：brew install coreutils，并改用 gdate。
3、重启终端或运行 starship explain 查看custom.time_ms是否被识别为活动模块。
四、配置条件性时间显示（基于目录或环境变量）
为避免时间戳始终占用提示符空间，可设定仅在进入项目根目录、或检测到特定环境变量时才显示时间，提升视觉简洁性与上下文相关性。
1、编辑 ~/.config/starship.toml，添加如下模块定义：
[custom.time_conditional]
command = '''if [ -n "$PROJECT_ROOT" ] || [ -f ".git" ]; then date "+%H:%M"; else echo ""; fi'''
when = '''[ -n "$PROJECT_ROOT" ] || [ -f ".git" ]'''
format = "? [$output](bold green)"
shell = ["bash"]
2、若使用zsh，将 shell = ["bash"] 改为 shell = ["zsh"]，并确保命令语法兼容。
3、设置测试环境变量：export PROJECT_ROOT=1，随后进入任意含.git的目录，观察时间是否按条件触发。
