如何为基于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
相关产品推荐
相关产品推荐

