starship美化教程
Win11 + Powershell
安装
在命令行使用下面命令安装
cmd
# 安装starship
winget install starship
将以下内容添加到 Microsoft.PowerShell_profile.ps1
,可以在 PowerShell 通过 $PROFILE
变量来查询文件的位置
Invoke-Expression (&starship init powershell)
配置
在C:\用户\{user}\.config
目录下新建starship.toml
文件,可以在starship官网查看官方预设配置,点击主题即可查看配置文件代码,复制到toml配置文件中即可。
需要注意的是,基本上所有的主题都包含了Nerd Font字体中的一些符号支持,因此当符号显示异常的话,先检查是否安装了最新版的Nerd Font字体族。
在排除字体问题后,某些符号显示异常很可能是使用了过时的符号编码,具体可见oh-my-posh美化教程中的Nerd Font部分。
启动终端后第一行空白
因为默认配置中add_newline = true
,意味着每次执行完命令会空出一行,防止命令与输出结果之间缺少空行而降低可读性。根据个人喜好,可以将其设置为false
以去除终端最上方的空行。
Linux(无root权限) + bash
安装Nerd Font
在linux终端中,可以使用fc-list
查看已安装的字体。
若linux上没有可用的Nerd Font字体,而你又恰好没有root权限,则可以在本地主机上下载字体包(.ttf文件即可)后上传至~/.local/share/fonts
目录下,若没有此路径,新建即可。
需要注意的是,在上传Nerd Font字体文件时,最好把某个字体的所有格式文件均上传,如light、bold、italic等多个文件。
然后在linux上执行以下命令来刷新字体缓存,检测字体是否可用。
bash
fc-cache -vf
fc-list | grep "JetBrainsMonoNLNerdFontMono"
安装starship
在starship的github官网上下载最新的starship压缩包,上传到linux用户目录下,解压即可得到starship的可执行文件,将该目录添加到环境变量中,再在~/.bashrc
文件的最后添加一行命令即可。
bash
# 将starship所在路径添加到环境变量
export PATH=/home/{user}/{starship所在目录}:$PATH
# 使用starship初始化bash
eval "$(starship init bash)"
配置
在~/.config
路径下新建starship.toml
配置文件即可。
我的配置
基于Tokyo Night
主题修改,增加了对conda
环境的显示支持与命令执行时长的显示支持。
大部分符号均需要在NerdFont下查看。
toml
add_newline = true
format = """
[░▒▓](#a3aed2)\
[ ](fg:#090c0c bg:#a3aed2)\
[](fg:#a3aed2 bg:#769ff0)\
$directory\
[](fg:#769ff0 bg:#596db0)\
$git_branch\
$git_status\
[](fg:#596db0 bg:#394260)\
$conda\
$nodejs\
$rust\
$golang\
$php\
[](fg:#394260 bg:#212736)\
$time\
[ ](fg:#212736 bg:#1d2230)\
$cmd_duration\
[](fg:#1d2230)\
\n$character"""
[directory]
style = "fg:#e3e5e5 bg:#769ff0"
format = "[ $path ]($style)"
truncation_length = 7
truncation_symbol = ".../"
[directory.substitutions]
"Documents" = " "
"Downloads" = " "
"Music" = " "
"Pictures" = " "
[git_branch]
symbol = ""
style = "bg:#394260"
format = '[[ $symbol $branch ](fg:#769ff0 bg:#596db0)]($style)'
[git_status]
style = "bg:#394260"
format = '[[($all_status$ahead_behind )](fg:#769ff0 bg:#596db0)]($style)'
[conda]
symbol = " "
style = "bg:#394260"
format = '[[ $symbol ($environment) ](fg:#769ff0 bg:#394260)]($style)'
[nodejs]
symbol = ""
style = "bg:#394260"
format = '[[ $symbol ($version) ](fg:#769ff0 bg:#394260)]($style)'
[rust]
symbol = ""
style = "bg:#394260"
format = '[[ $symbol ($version) ](fg:#769ff0 bg:#394260)]($style)'
[golang]
symbol = ""
style = "bg:#394260"
format = '[[ $symbol ($version) ](fg:#769ff0 bg:#394260)]($style)'
[php]
symbol = ""
style = "bg:#394260"
format = '[[ $symbol ($version) ](fg:#769ff0 bg:#394260)]($style)'
[time]
disabled = false
time_format = "%R" # Hour:Minute Format
style = "bg:#212736"
format = '[[ $time ](fg:#a0a9cb bg:#212736)]($style)'
[cmd_duration]
disabled = false
min_time = 500
show_milliseconds = true
style = "bg:#1d2230"
format = '[[ $duration ](fg:#a0a9cb bg:#1d2230)]($style)'