x starship | x-cmd mod | 为 starship 设计的增强模块

2 min read Original article ↗

starship 是一个适用于多种 Shell 的极简、超快且无限可定制的命令行提示！
有关入门指南的详细说明，请查看 https://starship.rs 上的文档。

starship 模块是为 starship 设计的增强型模块，用户可以一键轻松切换主题。
该模块还包括一个主题预览功能，允许用户直接在命令行中预览不同的主题，简化了选择和更改主题的过程。

TIP

当前模块 try/untry 功能仅适用于 bash 和 zsh 环境 使用 starship 模块的主题将覆盖当前环境的 STARSHIP_CONFIG 变量

例子 ​

调用 x starship fz 命令，交互式预览 starship 主题

全局使用 'gruvbox-rainbow' 主题

sh

x starship use gruvbox-rainbow

全局使用自定义配置主题

sh

x starship use path/to/custom.toml

取消全局使用的主题

在当前会话尝试使用 'pastel-powerline' 主题

sh

x starship try pastel-powerline

查看当前使用的主题配置

子命令 ​

名称描述
x starship ls罗列所有主题
x starship fz交互式罗列所有主题的预览效果
x starship which获取指定主题的配置文件路径
x starship update更新所有主题配置和预览文件
x starship use全局使用指定的主题
x starship unuse取消全局使用的主题
x starship try在当前会话尝试使用指定主题
x starship untry取消当前会话尝试使用的主题
x starship current显示当前使用的提示主题
x starship feature管理当前主题的 feature 功能
x starship --使用 starship 原生命令

x starship ls ​

罗列所有主题

  • 使用:

x starship fz ​

交互式罗列所有主题的预览效果

  • 使用:

x starship which ​

获取指定主题的配置文件路径

  • 使用:

x starship update ​

更新所有主题配置和预览文件

  • 使用:

x starship use ​

全局使用指定的主题

  • 例子:

全局使用 'gruvbox-rainbow' 主题

sh

x starship use gruvbox-rainbow

设置在 VSCode 终端环境全局使用 'no-nerd-font' 主题

sh

x starship use --vscode no-nerd-font

全局使用自定义配置主题

sh

x starship use <custom file path>

设置在 Fish shell 环境使用 'gruvbox-rainbow' 主题

sh

x starship use --shell fish gruvbox-rainbow
  • 使用:

x starship unuse ​

取消全局使用的主题

  • 使用:

x starship try ​

在当前会话尝试使用指定主题

  • 使用:

x starship untry ​

取消当前会话尝试使用的主题

  • 使用:

x starship current ​

显示当前使用的提示主题

  • 使用:

x starship feature ​

管理当前主题的 feature 功能

  • 子命令:
名称描述
x starship feature use设置全局的主题 feature，如果不指定 terminal 环境，则更改的是默认 terminal 环境的值
x starship feature cat查看全局的 feature 配置文件
x starship feature get获取当前环境中指定 feature 的值

x starship feature use ​

设置全局的主题 feature，如果不指定 terminal 环境，则更改的是默认 terminal 环境的值

  • 子命令:
名称描述
x starship feature use zshplugin加载默认的 zsh 插件 (zsh-syntax-highlighting、zsh-autosuggestions、zsh-config)

x starship feature use zshplugin ​

加载默认的 zsh 插件 (zsh-syntax-highlighting、zsh-autosuggestions、zsh-config)

  • 使用:

sh

x starship feature use zshplugin <#1>
  • 参数:
参数描述
#1策略
always | never | auto

x starship feature cat ​

查看全局的 feature 配置文件

  • 使用:

x starship feature get ​

获取当前环境中指定 feature 的值

  • 使用:

sh

x starship feature get <#1>
  • 参数:

x starship -- ​

使用 starship 原生命令

  • 使用:

TIP

在交互式终端中（如 zsh, bash ...），可以使用 Tab 获取补全信息

运行 CMD SUBCOMMAND --help 可以获取命令的更多信息