如何在Ruby CLI工具中实现类似less的大输出滚动浏览功能

针对你需要在Thor工具中展示大量diff内容并支持分页滚动的需求，以下是几种实用方案：

方案一：调用系统less命令（推荐，用户熟悉操作） #

Alpine Linux默认没有预装less，需要先在Docker容器中安装，之后直接将输出管道到less，复用它的翻页、搜索等成熟功能。

步骤： #

1. 在Dockerfile中添加less安装命令：

FROM ruby:3.2-alpine

# 安装less工具
RUN apk add --no-cache less

WORKDIR /app
COPY Gemfile Gemfile.lock ./
RUN bundle install
COPY . .

ENTRYPOINT ["bundle", "exec", "thor"]

2. 在Thor任务中调用less：

desc 'show_changes', '展示变更列表并分页浏览'
def show_changes
  # 生成你的结构化diff内容
  diff_content = generate_large_diff()

  # 检查less是否可用，不可用时降级直接输出
  if system('which less > /dev/null 2>&1')
    # 将内容传入less进程
    IO.popen('less', 'w') do |io|
      io.puts diff_content
    end
  else
    puts "警告：未安装less，将直接输出全部内容"
    puts diff_content
  end

  # 询问用户是否继续
  if yes?("是否处理下一组变更?")
    process_next_changes()
  end
end

优缺点： #

• 优点：用户熟悉less操作（翻页、搜索、退出快捷键），无需额外Ruby依赖
• 缺点：依赖系统工具，需要提前安装

方案二：使用Ruby纯分页Gem（无系统依赖） #

如果不想依赖系统less，可以用专门的终端分页Gem，比如tty-pager，它纯Ruby实现，跨平台兼容。

步骤： #

1. 在Gemfile中添加依赖：

gem 'tty-pager'

2. 在Thor任务中使用：

require 'tty-pager'

desc 'show_changes', '展示变更列表并分页浏览'
def show_changes
  diff_content = generate_large_diff()

  begin
    # 初始化分页器并展示内容
    TTY::Pager.new.page(diff_content)
  rescue TTY::Pager::Error => e
    # 分页失败时降级输出
    puts "分页出错：#{e.message}"
    puts diff_content
  end

  if yes?("是否处理下一组变更?")
    process_next_changes()
  end
end

优缺点： #

• 优点：不依赖系统工具，纯Ruby实现，适配不同终端环境
• 缺点：需要额外引入Gem，安装包体积略有增加

方案三：手动实现简易分页（轻量无依赖） #

如果需要极致轻量，不想加任何依赖，可以手动实现按屏输出、回车继续的逻辑。

代码示例： #

desc 'show_changes', '展示变更列表并分页浏览'
def show_changes
  diff_content = generate_large_diff()
  lines = diff_content.split("\n")
  # 获取终端高度，留两行作为提示行
  terminal_height = IO.console.winsize[0] - 2

  lines.each_slice(terminal_height) do |line_slice|
    line_slice.each { |line| puts line }
    puts "\n-- 按回车继续 | 输入q退出 --"
    input = gets.chomp
    break if input.downcase == 'q'
  end

  if yes?("是否处理下一组变更?")
    process_next_changes()
  end
end

优缺点： #

• 优点：无任何依赖，代码简单直接
• 缺点：功能有限，没有搜索、快速翻页等高级操作

内容的提问来源于stack exchange，提问作者Kelly Bennett