Starship

名称、版本与用途

名称：Starship
当前版本：1.24.2
路径：/usr/local/bin/starship
用途：跨 Shell 的可配置提示符，展示目录、Git 状态、语言版本、容器上下文和命令耗时。

starship --version
starship explain

基本语法（Synopsis）

starship [OPTIONS] <COMMAND> [ARGS]

[] 表示可选项，... 表示可重复；大写名称表示需要替换的参数。

当前安装与更新

当前为独立 Linux 二进制，不属于 dpkg。它与本地 terminal-setup/bin/linux-x86_64/starship 及离线 bundle 中的资产一致。

官方安装器可原地替换程序，不会覆盖 starship.toml：

curl -sS https://starship.rs/install.sh | sh

在执行联网安装脚本前应先查看脚本或使用官方 release。当前二进制位于 /usr/local/bin，更新可能需要 sudo。

配置文件

当前配置：~/.config/starship.toml
当前主题：Catppuccin Mocha
当前模块包括：OS、用户、目录、Git、Node、C、Rust、Go、PHP、Java、Kotlin、Haskell、Python、Docker、Conda、时间和命令耗时。

检查最终配置：

starship print-config
starship timings
starship config --help

zsh 启动集成

是，.zshrc 中直接执行：

eval "$(starship init zsh)"

Oh My Zsh 的 ZSH_THEME 当前为空，避免与 Starship 同时控制 Prompt。

基本功能与推荐用法

starship explain                    # 解释当前显示的模块
starship timings                    # 查找慢模块
starship preset plain-text-symbols  # 输出一个预设
starship module git_status          # 单独渲染模块
starship print-config               # 查看合并后的配置

示例中的选项、参数与子命令

本表解释本页示例实际出现的选项、参数、子命令及必要的辅助命令语法。

语法元素	含义
`--version`	显示版本。
`explain`	解释当前提示符中各模块的匹配原因。
`timings`	显示各模块的渲染耗时。
`config --help`	显示 config 子命令帮助。
`preset NAME`	输出指定预设配置。
`module NAME`	渲染单个提示符模块。
`print-config`	输出合并后的有效配置。
`init zsh`	输出适用于 zsh 的初始化脚本。
`curl -sS`	静默下载，但仍显示错误。

Liyuan Notes

探索

starship