如何在Django View中实现Excel文件下载功能？

核心思路 #

Django推荐使用FileResponse处理文件下载，它支持流式传输，不会将整个文件加载到内存，尤其适合Excel这类可能较大的文件。下面分两种常见场景给出实现方案：

1. 函数视图实现 #

from django.http import FileResponse, HttpResponseNotFound
import os
from django.conf import settings

def download_excel(request):
    # 拼接文件路径：假设Excel文件放在项目根目录下的files文件夹中，文件名为data.xlsx
    file_path = os.path.join(settings.BASE_DIR, 'files', 'data.xlsx')
    
    # 先检查文件是否存在
    if not os.path.exists(file_path):
        return HttpResponseNotFound("请求的文件不存在")
    
    # 以二进制只读模式打开文件，生成响应
    with open(file_path, 'rb') as excel_file:
        response = FileResponse(
            excel_file,
            content_type='application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
        )
        # 设置响应头，指定下载时显示的文件名
        response['Content-Disposition'] = 'attachment; filename="data.xlsx"'
        return response

2. 类视图实现（更适合复杂场景扩展） #

from django.views import View
from django.http import FileResponse, HttpResponseNotFound
import os
from django.conf import settings

class ExcelDownloadView(View):
    def get(self, request):
        file_path = os.path.join(settings.BASE_DIR, 'files', 'data.xlsx')
        
        if not os.path.exists(file_path):
            return HttpResponseNotFound("请求的文件不存在")
        
        response = FileResponse(
            open(file_path, 'rb'),
            content_type='application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
        )
        response['Content-Disposition'] = 'attachment; filename="data.xlsx"'
        return response

关键注意事项 #

• 路径规范：不要直接把文件放在项目根目录，建议创建files或static/files专用目录，同时在.gitignore中添加该目录（如果不需要将Excel文件提交到版本控制）。
• Content-Type设置：根据Excel版本选择对应的类型：
  • .xlsx文件：application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • .xls文件：application/vnd.ms-excel
• 中文文件名处理：如果文件名包含中文，需要对文件名进行URL编码，避免乱码：

  from urllib.parse import quote
  
  filename = "业务数据.xlsx"
  encoded_filename = quote(filename)
  response['Content-Disposition'] = f'attachment; filename="{encoded_filename}"; filename*=UTF-8''"{encoded_filename}"'
  

• 权限控制：如果需要限制下载权限（比如仅登录用户可下载），函数视图可添加@login_required装饰器，类视图可继承LoginRequiredMixin。

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