Starship Tokyo Night 预设实战一键应用 Powerline 风格配色与完整 TOML 配置详解【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本文基于 Starship 官方文档中的 Tokyo Night 预设页面docs/id-ID/presets/tokyo-night.md其内容与英文原版 docs/presets/tokyo-night.md 一致完整讲解该预设的适用前提、安装命令、逐段 TOML 配置参数并结合仓库源码说明starship preset子命令的底层实现机制。读完后你不仅能一键套用该深色 Powerline 主题还能理解每个颜色值、格式字符串与模块参数的作用从而安全地二次定制配色。预设定位与前置要求Tokyo Night 是一个受 tokyo-night VSCode 主题启发的社区提交预设收录于官方预设集合 docs/presets/README.md 中。它通过多段背景色渐变#a3aed2→#769ff0→#394260→#212736→#1d2230构成典型的 Powerline 风格提示符从操作系统徽标、目录、Git 状态到语言运行时与系统时间依次排列。文档明确列出唯一前置条件终端需安装并启用 Nerd Font。该预设大量使用 Nerd Font 私用区图标如分支符号、各发行版徽标、文档/下载/音乐等目录替换符号若终端字体不支持这些符号会显示为方块或空字符。一键应用预设应用方式只有一条命令starship preset tokyo-night -o ~/.config/starship.toml这条命令会把预设 TOML 内容直接写入~/.config/starship.toml即 starship 默认的配置文件路径覆盖写入前不会自动备份若目标文件已存在且你不想覆盖可加--force相关控制或直接改为输出到 stdout 查看内容starship preset tokyo-night # 打印到 stdout不落盘 starship preset --list # 列出全部可用预设名源码实现preset 子命令如何工作从源码结构看preset是一个独立的子命令定义于 src/main.rs#L102-L116支持三个参数name预设名必须是编译期内置枚举print::Preset中的合法值-o/--output将内容写入指定文件而非 stdout-f/--force已存在时强制覆盖且仅在指定了 output 时可用-l/--list列出所有预设名。真正的执行逻辑在 src/print.rs#L530-L546 的preset_command中预设内容通过shadow::get_preset_content(name)获取——Cargo.toml引入了shadow-rsfeatures 含build并在包元数据中声明了docs/public/presets/toml/目录见 Cargo.toml 中docs/public/presets/toml/条目。从源码结构看构建时会把该目录下的全部预设 TOML 嵌入二进制因此预设内容随 starship 二进制一起分发运行时不依赖网络或本地文档目录指定-o时调用crate::utils::write_file_atomic原子写文件失败则以退出码 1 报错否则写入 stdout。对应的回归测试包括preset_command_does_not_panic_on_correct_inputs、preset_command_output_to_file与preset_command_output_existing_file_force见 src/print.rs#L683-L708覆盖了“写入新文件”与“force 覆盖已存在文件”两条路径。完整 TOML 配置官方预设原文以下为预设的完整内容对应仓库文件 docs/public/presets/toml/tokyo-night.toml文档页通过 /public/presets/toml/tokyo-night.toml内嵌展示$schema https://starship.rs/config-schema.json format [░▒▓](#a3aed2)\ $os\ \ $directory\ \ $git_branch\ $git_status\ \ $nodejs\ $bun\ $rust\ $golang\ $php\ \ $time\ \ \n$character [directory] style fg:#e3e5e5 bg:#769ff0 format $path truncation_length 3 truncation_symbol …/ [directory.substitutions] Documents Downloads Music Pictures [git_branch] symbol style bg:#394260 format [ $symbol $branch ]($style) [git_status] style bg:#394260 format [($all_status$ahead_behind )]($style) [jj_bookmark] symbol style bg:#394260 format [ $symbol $bookmark($remote)$diverged( \($overflow_count others\)) ]($style) [nodejs] symbol style bg:#212736 format [ $symbol ($version) ]($style) [bun] symbol style bg:#212736 format [ $symbol ($version) ]($style) [rust] symbol style bg:#212736 format [ $symbol ($version) ]($style) [golang] symbol style bg:#212736 format [ $symbol ($version) ]($style) [php] symbol style bg:#212736 format [ $symbol ($version) ]($style) [time] disabled false time_format %R # Hour:Minute Format style bg:#1d2230 format [ $time ]($style) [os] style bg:#a3aed2 fg:#090c0c format $symbol disabled false [os.symbols] Windows Ubuntu SUSE Raspbian Mint Macos Manjaro Linux Gentoo Fedora Alpine Amazon Android AOSC Arch Artix EndeavourOS CentOS Debian Redhat RedHatEnterprise Pop 说明上方os.symbols及substitutions中的图标、git_branch/jj_bookmark/time的symbol均为 Nerd Font 私用区码点字符这里以空白占位展示实际复制请以 docs/public/presets/toml/tokyo-night.toml 原文为准或直接用starship preset tokyo-night -o生成避免手工复制丢失图标。顶层 formatPowerline 色带如何拼接顶层format是整个预设的骨架其渲染顺序为░▒▓ → $os → $directory → $git_branch $git_status → 运行时(nodejs/bun/rust/golang/php) → $time → 换行 → $character要点拆解[░▒▓](#a3aed2)提示符起始的三个“密度块”字符着色为 Tokyo Night 的柔和蓝紫#a3aed2作为视觉锚点Powerline 过渡符每两个模块之间插入了一个带bg:/fg:的空格如 。在启用 Nerd Font 时该空格位置渲染为 powerline 三角连接符前景色等于上一段背景色、背景色等于下一段背景色从而形成无缝色带衔接——这是 Powerline 主题的核心技巧颜色梯度#a3aed2OS 段→#769ff0目录段→#394260Git 段→#212736运行时段→#1d2230时间段由浅入深与终端深色背景自然融合\n$character换行后输出命令符$character默认配置下成功为❯蓝色、失败为❯红色保证多行命令输入时提示符独占一行。各模块的完整格式语法的详细说明可参考 docs/config/README.md全部合法键可用 docs/public/config-schema.json 校验。各模块配置逐项解析[directory]目录显示与截断style fg:#e3e5e5 bg:#769ff0 format $path truncation_length 3 truncation_symbol …/ [directory.substitutions] Documents ...truncation_length 3只保留路径最后 3 级更深的上级目录被折叠truncation_symbol …/折叠处显示省略号加斜杠substitutions把Documents、Downloads、Music、Pictures四个目录名替换为对应图标Nerd Font这是 Starship 路径替换特性的实际应用目录段背景色#769ff0、前景近白#e3e5e5是整条色带中对比最强的一段突出当前路径。[git_branch] / [git_status]Git 双模块git_branch的format [ $symbol $branch ]($style)分支名渲染为浅蓝前景 深蓝背景symbol为 Nerd Font 的 git 分支图标git_status紧跟其后$all_status新增/修改/未跟踪等状态字符汇总与$ahead_behind领先/落后计数共用同一段背景色#394260与分支段无缝衔接两个模块均无when_unmodified/disabled设置因此只要目录不是 Git 仓库这两段自动不显示。[jj_bookmark]Jujutsu VCS 的等价分支段symbol style bg:#394260 format [ $symbol $bookmark($remote)$diverged( \($overflow_count others\)) ]($style)这段为使用 Jujutsujj的仓库提供与git_branch相同配色的书签显示$bookmark($remote)展示书签及其远端$diverged在书签分叉时追加溢出计数。若你只用 Git此段不产生任何输出。运行时模块nodejs / bun / rust / golang / php五个运行时模块共享完全相同的样式模板style bg:#212736 format [ $symbol ($version) ]($style)即“图标 括号内版本号”统一浅蓝前景、次深色背景。它们的显隐由 starship 的目录探测逻辑决定——以 Rust 为例模块实现位于 src/modules/rust.rs其配置解析位于 src/configs/rust.rs当 starship 在当前目录树中发现 Rust 项目标识文件时才会输出该段。五个模块在顶层 format 中并列声明意味着同一项目同时满足多个运行时条件时各段会依次拼接在同一色带中。[time]默认关闭的系统时间被启用disabled false time_format %R # Hour:Minute Format style bg:#1d2230 format [ $time ]($style)starship 的time模块默认是禁用的此处显式disabled false打开time_format %R使用 strftime 的HH:MM24 小时制“时:分”时间前缀符号为 Nerd Font 时钟图标前景#a0a9cb背景#1d2230是整个提示符最深的色块作为色带收尾。[os]按发行版切换徽标style bg:#a3aed2 fg:#090c0c format $symbol disabled false [os.symbols] Windows Ubuntu ...与time类似os模块同样需要disabled false显式启用os.symbols映射覆盖 Windows、Ubuntu、SUSE、Raspbian、Mint、Macos、Manjaro、Linux通用、Gentoo、Fedora、Alpine、Amazon、Android、AOSC、Arch、Artix、EndeavourOS、CentOS、Debian、Redhat、RedHatEnterprise、Pop 共 22 个系统值均为 Nerd Font 品牌图标未匹配到的系统会回退到 starship 内置的默认os.symbols各 OS 的国旗/徽标。二次定制建议在理解上述结构后常见的安全定制方向只保留部分运行时在顶层format中删掉$bun、$php等占位符即可无需删除模块配置段调整色带五段背景色是唯一定义处把#769ff0系列整体换成其他主题的色板即可得到新主题注意保持“过渡符前景 上一段背景、背景 下一段背景”的衔接关系时间格式%R可改为%H:%M:%S等任意 strftime 表达式模块支持的完整键见 docs/config/README.md 的 time 一节无 Nerd Font 环境官方另提供纯文本风格的 plain-text 预设 与 no-nerd-font 预设可对照其符号替换思路改造本预设。小结Tokyo Night 预设的完整落地路径只有三步终端安装 Nerd Font → 执行starship preset tokyo-night -o ~/.config/starship.toml→ 重启 shell。而这份 100 余行的 TOML 本身是一份很好的 Starship 格式语法范例顶层format负责色带拼接与模块编排各模块段通过style/format/symbol统一 Tokyo Night 色板disabled/substitutions/truncation_length则展示了 Starship 的开关、路径替换与截断三项实用特性。预设内容由构建期内嵌进二进制shadow-rs docs/public/presets/toml/ 目录starship preset子命令src/print.rs#L530-L546负责输出或原子写盘因此该命令在任何装有 starship 的机器上都可以离线复现同一份配置。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Starship Tokyo Night 预设实战：一键应用 Powerline 风格配色与完整 TOML 配置详解
Starship Tokyo Night 预设实战一键应用 Powerline 风格配色与完整 TOML 配置详解【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本文基于 Starship 官方文档中的 Tokyo Night 预设页面docs/id-ID/presets/tokyo-night.md其内容与英文原版 docs/presets/tokyo-night.md 一致完整讲解该预设的适用前提、安装命令、逐段 TOML 配置参数并结合仓库源码说明starship preset子命令的底层实现机制。读完后你不仅能一键套用该深色 Powerline 主题还能理解每个颜色值、格式字符串与模块参数的作用从而安全地二次定制配色。预设定位与前置要求Tokyo Night 是一个受 tokyo-night VSCode 主题启发的社区提交预设收录于官方预设集合 docs/presets/README.md 中。它通过多段背景色渐变#a3aed2→#769ff0→#394260→#212736→#1d2230构成典型的 Powerline 风格提示符从操作系统徽标、目录、Git 状态到语言运行时与系统时间依次排列。文档明确列出唯一前置条件终端需安装并启用 Nerd Font。该预设大量使用 Nerd Font 私用区图标如分支符号、各发行版徽标、文档/下载/音乐等目录替换符号若终端字体不支持这些符号会显示为方块或空字符。一键应用预设应用方式只有一条命令starship preset tokyo-night -o ~/.config/starship.toml这条命令会把预设 TOML 内容直接写入~/.config/starship.toml即 starship 默认的配置文件路径覆盖写入前不会自动备份若目标文件已存在且你不想覆盖可加--force相关控制或直接改为输出到 stdout 查看内容starship preset tokyo-night # 打印到 stdout不落盘 starship preset --list # 列出全部可用预设名源码实现preset 子命令如何工作从源码结构看preset是一个独立的子命令定义于 src/main.rs#L102-L116支持三个参数name预设名必须是编译期内置枚举print::Preset中的合法值-o/--output将内容写入指定文件而非 stdout-f/--force已存在时强制覆盖且仅在指定了 output 时可用-l/--list列出所有预设名。真正的执行逻辑在 src/print.rs#L530-L546 的preset_command中预设内容通过shadow::get_preset_content(name)获取——Cargo.toml引入了shadow-rsfeatures 含build并在包元数据中声明了docs/public/presets/toml/目录见 Cargo.toml 中docs/public/presets/toml/条目。从源码结构看构建时会把该目录下的全部预设 TOML 嵌入二进制因此预设内容随 starship 二进制一起分发运行时不依赖网络或本地文档目录指定-o时调用crate::utils::write_file_atomic原子写文件失败则以退出码 1 报错否则写入 stdout。对应的回归测试包括preset_command_does_not_panic_on_correct_inputs、preset_command_output_to_file与preset_command_output_existing_file_force见 src/print.rs#L683-L708覆盖了“写入新文件”与“force 覆盖已存在文件”两条路径。完整 TOML 配置官方预设原文以下为预设的完整内容对应仓库文件 docs/public/presets/toml/tokyo-night.toml文档页通过 /public/presets/toml/tokyo-night.toml内嵌展示$schema https://starship.rs/config-schema.json format [░▒▓](#a3aed2)\ $os\ \ $directory\ \ $git_branch\ $git_status\ \ $nodejs\ $bun\ $rust\ $golang\ $php\ \ $time\ \ \n$character [directory] style fg:#e3e5e5 bg:#769ff0 format $path truncation_length 3 truncation_symbol …/ [directory.substitutions] Documents Downloads Music Pictures [git_branch] symbol style bg:#394260 format [ $symbol $branch ]($style) [git_status] style bg:#394260 format [($all_status$ahead_behind )]($style) [jj_bookmark] symbol style bg:#394260 format [ $symbol $bookmark($remote)$diverged( \($overflow_count others\)) ]($style) [nodejs] symbol style bg:#212736 format [ $symbol ($version) ]($style) [bun] symbol style bg:#212736 format [ $symbol ($version) ]($style) [rust] symbol style bg:#212736 format [ $symbol ($version) ]($style) [golang] symbol style bg:#212736 format [ $symbol ($version) ]($style) [php] symbol style bg:#212736 format [ $symbol ($version) ]($style) [time] disabled false time_format %R # Hour:Minute Format style bg:#1d2230 format [ $time ]($style) [os] style bg:#a3aed2 fg:#090c0c format $symbol disabled false [os.symbols] Windows Ubuntu SUSE Raspbian Mint Macos Manjaro Linux Gentoo Fedora Alpine Amazon Android AOSC Arch Artix EndeavourOS CentOS Debian Redhat RedHatEnterprise Pop 说明上方os.symbols及substitutions中的图标、git_branch/jj_bookmark/time的symbol均为 Nerd Font 私用区码点字符这里以空白占位展示实际复制请以 docs/public/presets/toml/tokyo-night.toml 原文为准或直接用starship preset tokyo-night -o生成避免手工复制丢失图标。顶层 formatPowerline 色带如何拼接顶层format是整个预设的骨架其渲染顺序为░▒▓ → $os → $directory → $git_branch $git_status → 运行时(nodejs/bun/rust/golang/php) → $time → 换行 → $character要点拆解[░▒▓](#a3aed2)提示符起始的三个“密度块”字符着色为 Tokyo Night 的柔和蓝紫#a3aed2作为视觉锚点Powerline 过渡符每两个模块之间插入了一个带bg:/fg:的空格如 。在启用 Nerd Font 时该空格位置渲染为 powerline 三角连接符前景色等于上一段背景色、背景色等于下一段背景色从而形成无缝色带衔接——这是 Powerline 主题的核心技巧颜色梯度#a3aed2OS 段→#769ff0目录段→#394260Git 段→#212736运行时段→#1d2230时间段由浅入深与终端深色背景自然融合\n$character换行后输出命令符$character默认配置下成功为❯蓝色、失败为❯红色保证多行命令输入时提示符独占一行。各模块的完整格式语法的详细说明可参考 docs/config/README.md全部合法键可用 docs/public/config-schema.json 校验。各模块配置逐项解析[directory]目录显示与截断style fg:#e3e5e5 bg:#769ff0 format $path truncation_length 3 truncation_symbol …/ [directory.substitutions] Documents ...truncation_length 3只保留路径最后 3 级更深的上级目录被折叠truncation_symbol …/折叠处显示省略号加斜杠substitutions把Documents、Downloads、Music、Pictures四个目录名替换为对应图标Nerd Font这是 Starship 路径替换特性的实际应用目录段背景色#769ff0、前景近白#e3e5e5是整条色带中对比最强的一段突出当前路径。[git_branch] / [git_status]Git 双模块git_branch的format [ $symbol $branch ]($style)分支名渲染为浅蓝前景 深蓝背景symbol为 Nerd Font 的 git 分支图标git_status紧跟其后$all_status新增/修改/未跟踪等状态字符汇总与$ahead_behind领先/落后计数共用同一段背景色#394260与分支段无缝衔接两个模块均无when_unmodified/disabled设置因此只要目录不是 Git 仓库这两段自动不显示。[jj_bookmark]Jujutsu VCS 的等价分支段symbol style bg:#394260 format [ $symbol $bookmark($remote)$diverged( \($overflow_count others\)) ]($style)这段为使用 Jujutsujj的仓库提供与git_branch相同配色的书签显示$bookmark($remote)展示书签及其远端$diverged在书签分叉时追加溢出计数。若你只用 Git此段不产生任何输出。运行时模块nodejs / bun / rust / golang / php五个运行时模块共享完全相同的样式模板style bg:#212736 format [ $symbol ($version) ]($style)即“图标 括号内版本号”统一浅蓝前景、次深色背景。它们的显隐由 starship 的目录探测逻辑决定——以 Rust 为例模块实现位于 src/modules/rust.rs其配置解析位于 src/configs/rust.rs当 starship 在当前目录树中发现 Rust 项目标识文件时才会输出该段。五个模块在顶层 format 中并列声明意味着同一项目同时满足多个运行时条件时各段会依次拼接在同一色带中。[time]默认关闭的系统时间被启用disabled false time_format %R # Hour:Minute Format style bg:#1d2230 format [ $time ]($style)starship 的time模块默认是禁用的此处显式disabled false打开time_format %R使用 strftime 的HH:MM24 小时制“时:分”时间前缀符号为 Nerd Font 时钟图标前景#a0a9cb背景#1d2230是整个提示符最深的色块作为色带收尾。[os]按发行版切换徽标style bg:#a3aed2 fg:#090c0c format $symbol disabled false [os.symbols] Windows Ubuntu ...与time类似os模块同样需要disabled false显式启用os.symbols映射覆盖 Windows、Ubuntu、SUSE、Raspbian、Mint、Macos、Manjaro、Linux通用、Gentoo、Fedora、Alpine、Amazon、Android、AOSC、Arch、Artix、EndeavourOS、CentOS、Debian、Redhat、RedHatEnterprise、Pop 共 22 个系统值均为 Nerd Font 品牌图标未匹配到的系统会回退到 starship 内置的默认os.symbols各 OS 的国旗/徽标。二次定制建议在理解上述结构后常见的安全定制方向只保留部分运行时在顶层format中删掉$bun、$php等占位符即可无需删除模块配置段调整色带五段背景色是唯一定义处把#769ff0系列整体换成其他主题的色板即可得到新主题注意保持“过渡符前景 上一段背景、背景 下一段背景”的衔接关系时间格式%R可改为%H:%M:%S等任意 strftime 表达式模块支持的完整键见 docs/config/README.md 的 time 一节无 Nerd Font 环境官方另提供纯文本风格的 plain-text 预设 与 no-nerd-font 预设可对照其符号替换思路改造本预设。小结Tokyo Night 预设的完整落地路径只有三步终端安装 Nerd Font → 执行starship preset tokyo-night -o ~/.config/starship.toml→ 重启 shell。而这份 100 余行的 TOML 本身是一份很好的 Starship 格式语法范例顶层format负责色带拼接与模块编排各模块段通过style/format/symbol统一 Tokyo Night 色板disabled/substitutions/truncation_length则展示了 Starship 的开关、路径替换与截断三项实用特性。预设内容由构建期内嵌进二进制shadow-rs docs/public/presets/toml/ 目录starship preset子命令src/print.rs#L530-L546负责输出或原子写盘因此该命令在任何装有 starship 的机器上都可以离线复现同一份配置。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考