You need to enable JavaScript to run this app. 如何为基于down gem的Ruby文件下载器集成ruby-progressbar进度条
优惠活动
大模型
产品
解决方案
定价
更多

如何为基于down gem的Ruby文件下载器集成ruby-progressbar进度条

Down gem 集成 ruby-progressbar 可靠实现方案

错误原因说明

第一种使用progress_proc的写法失败,核心是ruby-progressbar默认进度最大值为100,而down的progress_proc回调传入的是已下载的字节绝对值,直接赋值会超出进度条最大值触发异常。

最优原生接口实现方案

完全基于down官方提供的progress_proc回调实现,无需自行维护下载计数逻辑,代码简洁可靠:

require "down"
require "ruby-progressbar"

# 封装为通用下载方法
def download_with_progress(url, save_path = nil)
  # 预获取文件总大小,用于进度条初始化
  source_io = Down.open(url)
  total_size = source_io.size

  # 初始化进度条,兼容服务器不返回Content-Length的场景
  progress_bar = ProgressBar.create(
    title: File.basename(save_path || "下载文件"),
    total: total_size,
    format: "%t |%w>%i| %p%% 剩余时间: %e",
    length: 80
  )

  # 执行下载,通过回调直接更新进度
  downloaded_file = Down.download(
    url,
    destination: save_path,
    progress_proc: ->(completed_bytes) { progress_bar.progress = completed_bytes }
  )

  progress_bar.finish
  downloaded_file
end

# 调用示例
download_with_progress("https://example.com/large_file.zip", "./local_save_path.zip")

自定义流式处理优化方案

如果需要自行处理下载分块(比如实时校验、断点续传等场景),可以用优化后的流式实现,解决原有写法的整数除法、固定块大小计数误差问题:

require "down"
require "ruby-progressbar"

def stream_download_with_progress(url, save_path, chunk_size = 1024*1024)
  source_io = Down.open(url)
  total_size = source_io.size

  progress_bar = ProgressBar.create(
    title: File.basename(save_path),
    total: total_size,
    format: "%t |%B| %p%% 已下载: %c/%C MB",
    humanize: true
  )

  File.open(save_path, "wb") do |write_io|
    until source_io.eof?
      chunk = source_io.read(chunk_size)
      write_io.write(chunk)
      progress_bar.progress += chunk.bytesize
    end
  end

  progress_bar.finish
end

注意事项

  • 若服务器不返回Content-Length响应头,source_io.size会返回nil,此时ruby-progressbar会自动切换为无总进度的流动展示样式,不会抛出异常。
  • 可根据需求调整进度条的format参数,自定义展示字段、样式长度等。

内容的提问来源于stack exchange,提问作者Hüseyin Tekinaslan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.18 22:27:01