Starship No Runtime Versions 预设在容器与虚拟化环境中隐藏语言运行时版本【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship本篇指南聚焦 Starship 官方预设No Runtime Versionsno-runtime-versions它通过重写各语言模块的format让提示符只显示语言图标、不再显示版本号。文章完整给出预设的启用命令与全量 TOML 配置并结合仓库源码src/main.rs、src/print.rs、src/configs/说明其底层实现原理帮助你在容器、虚拟化环境或追求极简提示符的场景下直接落地使用。这个预设解决什么问题Starship 的默认行为是进入某个语言项目目录后对应模块会同时渲染语言图标与版本号。例如在 Python 项目中默认显示 v3.11.4在 Node.js 项目中默认显示⬢ v18.17.0具体默认格式见下文源码分析。在以下场景中版本号反而是一种噪音容器Container环境镜像内预装的运行时版本通常与宿主机开发环境不一致显示出来的版本信息没有参考价值虚拟化 / 远程开发环境版本由基础设施统一固定无需在每次提示符中重复出现极简提示符诉求用户只想知道当前项目是什么语言不关心具体版本。No Runtime Versions 预设正是为这类场景设计它只保留语言符号隐藏运行时版本从而让提示符更干净、渲染更快速。该预设收录于官方预设集合 docs/presets/README.md可在各语言版本的文档中查看如本指南对应的意大利语页面 docs/it-IT/presets/no-runtimes.md。启用预设一条命令启用该预设只需在终端执行starship preset no-runtime-versions -o ~/.config/starship.toml命令会把预设内容覆盖写入Starship 配置文件~/.config/starship.toml。执行完成后重新加载 shell或新开终端即可看到效果语言图标保留、版本号消失。starship preset子命令参数从源码 src/main.rs 可以看到preset子命令支持以下参数参数说明-o, --output path将预设内容写入指定文件默认输出到 stdout与--list互斥-f, --force目标文件已存在时强制覆盖必须与--output搭配使用-l, --list列出当前 Starship 内置的全部预设名称不输出配置内容例如先查看内置预设清单starship preset --list输出中包含no-runtime-versions等所有可用预设名。若配置文件已存在且不希望手动确认可加--forcestarship preset no-runtime-versions -o ~/.config/starship.toml --force在 src/print.rs 的实现中preset_command会先读取内置预设内容再根据参数决定写入文件采用原子写入还是打印到 stdout若未指定--force且目标文件已存在写入会报错退出。因此该命令是覆盖式而非合并式——它会用预设内容整体替换原配置文件若你已有自定义配置请先备份。完整预设配置逐项解析预设的实际内容存放在仓库 docs/public/presets/toml/no-runtime-versions.toml核心思路是为每个语言模块重写format。全量内容如下$schema https://starship.rs/config-schema.json [bun] format via $symbol [buf] format with $symbol [c] format via $symbol($name) [cmake] format via $symbol [cobol] format via $symbol [cpp] format via $symbol($name) [crystal] format via $symbol [daml] format via $symbol [dart] format via $symbol [deno] format via $symbol [dotnet] format $symbol( $tfm ) [elixir] format via $symbol [elm] format via $symbol [erlang] format via $symbol [fennel] format via $symbol [fortran] format via $symbol [gleam] format via $symbol [golang] format via $symbol [gradle] format via $symbol [haskell] format via $symbol [haxe] format via $symbol [helm] format via $symbol [java] format via $symbol [julia] format via $symbol [kotlin] format via $symbol [lua] format via $symbol [maven] format via $symbol [meson] format via $symbol [mojo] format with $symbol [nim] format via $symbol [nodejs] format via $symbol [ocaml] format via $symbol(\($switch_indicator$switch_name\) ) [odin] format via $symbol [opa] format via $symbol [perl] format via $symbol [php] format via $symbol [pixi] format via $symbol($environment ) [pulumi] format via $symbol$stack [purescript] format via $symbol [python] format via $symbol [quarto] format via $symbol [raku] format via $symbol [red] format via $symbol [rlang] format via $symbol [ruby] format via $symbol [rust] format via $symbol [scala] format via $symbol [solidity] format via $symbol [swift] format via $symbol [typst] format via $symbol [vagrant] format via $symbol [vlang] format via $symbol [xmake] format via $symbol [zig] format via $symbol该预设共覆盖 54 个模块可以按保留内容分为三类纯符号型绝大多数如python、nodejs、rust、golang、java等format简化为via $symbol仅渲染图标buf、mojo使用with作为连接词其余使用via保留标识符namec与cpp使用via $symbol($name)仍显示编译器标识如gcc因为$name属于工具链名称而非版本号保留非版本信息dotnet$symbol( $tfm )保留目标框架target framework信息ocamlvia $symbol(\($switch_indicator$switch_name\) )保留 opam switch 指示与名称pixivia $symbol($environment )保留环境名pulumivia $symbol$stack保留栈名。可见该预设的定位是隐藏运行时版本而非隐藏一切额外信息。底层原理format 字符串与变量机制要理解这个预设为什么有效需要看 Starship 的模块渲染机制。每个模块的format是一个模板字符串由 src/formatter/ 中的StringFormatter解析支持$variable占位符与条件分组( ... )组内变量为空时整组不渲染。以默认配置为对照均来自仓库源码Python 模块默认格式定义于 src/configs/python.rsformat via ${symbol}${pyenv_prefix}(${version} )(\\($virtualenv\\) )包含$symbol、$pyenv_prefix、$version、$virtualenv多个变量Node.js 模块默认格式定义于 src/configs/nodejs.rsformat via $symbol($version )包含$version变量。预设所做的正是把这类包含$version的格式替换为只含$symbol的格式。以 Python 为例从默认的via [ ${pyenv_prefix}(v3.11.4 )(venv)]变为via []版本号与虚拟环境信息不再进入提示符。从实现层面看模块在渲染时会遍历format中的变量并逐个求值例如 Rust 模块在 src/modules/rust.rs 中通过map对version、numver、toolchain变量分别调用检测函数如get_module_version、get_module_numeric_version。当format中不再出现$version变量时对应的版本检测逻辑便不再被触发——既隐藏了版本信息也省去了运行时检测的子进程开销这对容器等受限环境尤为友好。手动等效配置与自定义扩展如果你不想整体覆盖配置文件也可以把预设内容合并进现有配置或只针对个别模块手动隐藏版本。手动等效配置以 Python、Node.js 为例[python] format via $symbol [nodejs] format via $symbol如需在预设基础上做微调例如把 Python 模块彻底关闭可在写入预设后追加[python] disabled true注意 TOML 中同名 table 是合并关系追加的键会覆盖预设值。若想恢复 Starship 默认外观删除~/.config/starship.toml中对应段落或直接删除文件并重载 shell 即可。验证配置是否生效写入预设后可用以下命令验证starship config python.format该命令会输出当前生效的 Python 模块format若为via $symbol说明预设已生效。也可以单独渲染某个模块查看效果starship module python输出中应只包含 Python 图标与样式不包含v开头的版本号。配置文件结构校验可参考仓库中发布的 JSON Schemadocs/public/config-schema.jsonStarship 会在加载配置时进行校验语法错误会在提示符渲染时报错提示。小结No Runtime Versions 预设以隐藏语言运行时版本为目标通过重写 54 个语言模块的format只保留图标及少量必要的非版本信息特别适合容器、虚拟化与极简提示符场景。其完整配置存放于 docs/public/presets/toml/no-runtime-versions.toml一条starship preset no-runtime-versions -o ~/.config/starship.toml即可启用理解format模板与$version变量的关系后你也可以在此基础上自由组合定制属于自己的去版本号提示符。【免费下载链接】starship☄️ The minimal, blazing-fast, and infinitely customizable prompt for any shell!项目地址: https://gitcode.com/GitHub_Trending/st/starship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考