企业官网建设流程全解析

• 开发工具

导读

本文聚焦 Spaceship Prompt 内建的ruby提示段（section）。该段会在当前目录位于 Ruby 项目内时自动检测并显示当前 Ruby 版本，同时兼容 rvm、chruby、rbenv、mise 与 asdf 五种主流版本管理器。读完本文，你将掌握ruby段的全部配置变量、项目识别规则、版本探测优先级，并能从源码层面理解其在 sections/ruby.zsh 中的完整实现逻辑。

一、什么是ruby提示段

Ruby 是一种动态、反射式、面向对象的通用编程语言。Spaceship Prompt 用ruby段在命令行提示符中展示当前使用的 Ruby 版本号，典型呈现效果为：

via 💎 v3.2.2

其中via为默认前缀，💎为段符号（symbol），v3.2.2为版本内容。该段由 sections/ruby.zsh 实现，在默认的 提示顺序（Prompt order） 中位于node、bun、deno之后、python之前。

二、显示条件：何时出现

ruby段只在当前目录属于 Ruby 项目时渲染，判断规则来自 sections/ruby.zsh 的源码：

# Show versions only for Ruby-specific folders local is_ruby_project="$(spaceship::upsearch Gemfile Rakefile)" [[ -n "$is_ruby_project" || -n *.rb(#qN^/) ]] || return

满足以下任一条件即判定为 Ruby 项目：

1. 向上搜索（upsearch）找到Gemfile或Rakefile文件；
2. 当前目录包含任意.rb文件（*.rb(#qN^/)为 Zsh 的 glob 限定符写法：N表示无匹配时不报错，^/表示排除目录）。

upsearch 的搜索边界

spaceship::upsearch定义于 lib/utils.zsh，会从当前目录逐级向父目录查找指定文件；若途中先遇到.git或.hg目录（仓库根），则停止向上继续搜索并返回失败。也就是说，项目根目录是Gemfile/Rakefile识别的天然边界——在 Git/Hg 仓库外嵌套的父目录中的同名文件不会被误判。

三、版本管理器支持：探测优先级

ruby段通过spaceship::exists（见 lib/utils.zsh，本质是对command -v的封装）依次探测可用的版本管理器，命中第一个即使用，探测顺序与对应命令如下：

对应源码见 sections/ruby.zsh。

后处理与版本规范化

版本号取出后还会经历两处修正（sections/ruby.zsh）：

• 若结果为空或为system（rbenv 等返回的全局系统版本），段直接隐藏不显示；
• 若版本号以数字开头，则自动加v前缀，如3.2.2→v3.2.2。

[[ -z $ruby_version || "${ruby_version}" == "system" ]] && return # Add 'v' before ruby version that starts with a number [[ "${ruby_version}" =~ ^[0-9].+$ ]] && ruby_version="v${ruby_version}"

四、配置选项

ruby段的所有选项均遵循SPACESHIP_<SECTION>_<OPTION>命名规范（见 提示配置文档）。完整选项如下：

上述默认值同时也在源码头部以${VAR=default}的形式显式声明（sections/ruby.zsh），允许用户在加载前通过环境变量覆盖。

使用示例

在~/.zshrc或 Spaceship 配置文件中添加：

# 显示 ruby 段 SPACESHIP_RUBY_SHOW=true # 隐藏版本号，仅展示符号（如不想暴露具体版本） # SPACESHIP_RUBY_SHOW=false # 自定义前缀、后缀与颜色 SPACESHIP_RUBY_PREFIX="ruby·" SPACESHIP_RUBY_SUFFIX=" " SPACESHIP_RUBY_COLOR="magenta" # 自定义符号 SPACESHIP_RUBY_SYMBOL="◆ "

颜色可取 Zsh 基本颜色名或 256 色颜色码，规则与其它提示段一致。

五、异步渲染机制

ruby段默认以异步方式渲染（SPACESHIP_RUBY_ASYNC=true）。异步渲染意味着版本探测命令（如rbenv version-name、asdf current）在后台执行，结果就绪后再刷新到提示符上，从而避免拖慢每次按键后提示符的响应速度。

该机制的判定入口位于 lib/utils.zsh 的spaceship::is_section_async：全局开关SPACESHIP_PROMPT_ASYNC（默认true）开启、且该段不在强制同步名单中、同时SPACESHIP_RUBY_ASYNC为true时，ruby段即异步渲染。在结果未返回前，提示符中会由async段占位（详见 async 段文档）。

如需改为同步渲染，可设置：

SPACESHIP_RUBY_ASYNC=false

六、与渲染管线的关系

ruby段最终通过spaceship::section函数打包为数据元组后交给渲染管线（sections/ruby.zsh）：

spaceship::section \ --color "$SPACESHIP_RUBY_COLOR" \ --prefix "$SPACESHIP_RUBY_PREFIX" \ --suffix "$SPACESHIP_RUBY_SUFFIX" \ --symbol "$SPACESHIP_RUBY_SYMBOL" \ "$ruby_version"

spaceship::section的签名与各参数含义详见 段 API 文档：--color控制内容颜色，--prefix与--suffix分别为前后装饰，--symbol在内容前渲染。渲染阶段由spaceship::section::render完成，且遵循全局的SPACESHIP_PROMPT_PREFIXES_SHOW/SPACESHIP_PROMPT_SUFFIXES_SHOW等提示级选项（见 提示配置文档）。这也解释了为何默认情况下首段前缀会被隐藏、而ruby段正常显示via·前缀。

若想调整ruby段在提示符中的位置，可用 Spaceship CLI 增删：

# 将 ruby 从提示顺序中移除 spaceship remove ruby # 加回提示顺序（默认插在队尾，可用 spaceship add 结合顺序参数精确放置） spaceship add ruby

七、小结

ruby段是 Spaceship Prompt 中对 Ruby 开发者最实用的提示段之一：

• 智能触发：通过Gemfile/Rakefile向上搜索与.rb文件检测，只在 Ruby 项目中显示；
• 多管理器兼容：按 rvm → chruby → rbenv → mise → asdf 的顺序自动探测，无需手动配置；
• 细节打磨：自动补充v前缀、过滤system版本、默认异步渲染保证提示符流畅。

全部默认配置与实现逻辑均可在 sections/ruby.zsh 中直接查阅，其配套的英文原版文档见 docs/sections/ruby.md。

• 开发工具