如何修改Rails 7中ActiveStorage附件各变体的文件名？

你可以通过两种实用方式为每个变体重命名下载文件：

方法一：直接在视图链接中指定文件名 #

利用Active Storage提供的文件名相关方法，拼接原始文件名与变体名称，直接在rails_blob_path中传入filename参数即可：

<%= link_to rails_blob_path(
  @post.image.variant(:cover),
  disposition: "attachment",
  filename: "#{@post.image.filename.base}-cover.#{@post.image.filename.extension}"
), class: "hover:underline" do %>
  下载封面图
<% end %>

• filename.base：获取原始文件名的主体部分（不含扩展名）
• filename.extension：获取原始文件的扩展名
• 拼接变体名称后，下载时浏览器会使用类似my-photo-cover.jpg的自定义文件名

方法二：通过控制器动作处理（适合复杂逻辑） #

如果需要更灵活的文件名规则（比如添加时间戳、用户标识等），可以在控制器中新增下载动作：

1. 添加控制器动作 #

# app/controllers/posts_controller.rb
def download_variant
  @post = Post.find(params[:id])
  variant_key = params[:variant].to_sym
  variant = @post.image.variant(variant_key)
  
  # 自定义文件名规则
  original_name = @post.image.filename.base
  extension = @post.image.filename.extension
  custom_filename = "#{original_name}-#{variant_key}-#{Time.current.strftime('%Y%m%d')}.#{extension}"

  send_data(
    variant.processed.download,
    filename: custom_filename,
    type: variant.content_type,
    disposition: "attachment"
  )
end

2. 添加路由 #

# config/routes.rb
resources :posts do
  get "download/:variant", to: "posts#download_variant", as: :download_variant
end

3. 视图中使用新链接 #

<%= link_to download_variant_post_path(@post, :cover), class: "hover:underline" do %>
  下载封面图
<% end %>

根据你的需求选择对应的方式即可解决下载文件名统一的问题。

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