创建模型
首先先进入我们的testsite项目下，打开members/models.py文件，先添加我们保存文件的数据模型：
class Document(models.Model): name = models.CharField(max_length=255) file = models.FileField(upload_to='uploads/') # 'uploads/' 是文件上传的相对路径 uploaded_at = models.DateTimeField(auto_now_add=True)
这里的文件存储目录可以自定义我们需要存储文件的目录，也可以在我们的 env文件 做配置，这里直接读取相应的配置 env字段 就可以了。
进入testsite根目录执行更新迁移文件命令，这一步前面有说到，是为了更新迁移文件。
py manage.py makemigrations
可以看到我们的migrations目录增加了新的迁移文件
执行迁移
py manage.py migrate
我们新增加的文件模型表就在数据库生成好了。
使用模型
进入testsite/members目录，新增form.py表单文件，这里会定义文件上传的字段。
from django import forms from .models import Document class UploadFileForm(forms.ModelForm): class Meta: model = Document fields = ['name', 'file'] # 包含你想要用户填写的字段
接下来将上传的文件绑定到表单中，打开testsite/members/views.py视图文件：
from .forms import UploadFileForm #需要我们引入上一步建立好的表单文件 def upload_file(request): if request.method == "POST": form = UploadFileForm(request.POST, request.FILES) if form.is_valid(): form.save() # 保存表单数据到数据库 return HttpResponse("上传成功") else: form = UploadFileForm() return render(request, "polls/upload.html", {"form": form})
我们传递request.FILES 到表单的构造函数；这就是文件数据绑定到表单的方式。
请注意，request.FILES仅当请求方法为POST，实际发送了至少一个文件字段且<form>表单有发送请求的并且具有enctype="multipart/form-data"属性时。否则request.FILES将为空。
最后一步，添加上传页面，进入members/templates/members目录，新增upload.html文件，注意跟我们的视图里面指向的文件名保持一致。
<form method="post" enctype="multipart/form-data"> {% csrf_token %} {{ form.as_p }} <button type="submit">提交</button> </form>
打开地址http://127.0.0.1:8000/polls/upload/进入文件上传页面
点写完表单点击提交
这个时候我们的文件上传就完成了，可以打开我们的testsite目录，进入我们设置的uploads目录，就看到我们上传好的文件：
然后我们再打开数据库，进入模型对应的members_document表，也可以看到文件上传生成的数据。
批量上传
为了使用一个表单字段上传多个文件，创建该字段的子类并将其allow_multiple_selected类属性设置为True。
进入表单文件forms.py：
class MultipleFileInput(forms.ClearableFileInput): allow_multiple_selected = True class MultipleFileField(forms.FileField): def __init__(self, *args, **kwargs): kwargs.setdefault("widget", MultipleFileInput()) super().__init__(*args, **kwargs) def clean(self, data, initial=None): single_file_clean = super().clean if isinstance(data, (list, tuple)): result = [single_file_clean(d, initial) for d in data] else: result = [single_file_clean(data, initial)] return result class FileFieldForm(forms.Form): file_field = MultipleFileField()
然后进入view.py视图文件重写子类form_valid()的方法 FormView来处理多个文件上传：
from .forms import FileFieldForm # 确保导入正确的表单定义 from .models import Document # 引入Document模型 def batch_upload_view(request): if request.method == 'POST': form = FileFieldForm(request.POST, request.FILES) if form.is_valid(): # 获取表单中title的值 title = form.cleaned_data['title'] # 处理文件上传 for file in request.FILES.getlist('file_field'): document = Document(file=file, name=title) # 假设title作为文件的名称或描述 document.save() return HttpResponse("上传成功") else: # 请求方法为GET时，初始化表单 form = FileFieldForm() return render(request, "polls/uploads.html", {"form": form})
假如你不想使用模型关联上传，则使用如下方式：
from django.core.files.storage import default_storage #使用默认存储引擎保存文件 file_name = default_storage.save(file.name, file)
然后重新渲染我们的批量上传页面，跟我们的forms django表单关联
<form method="post" enctype="multipart/form-data"> <!-- enctype 必须为 multipart/form-data 以支持文件上传 --> {% csrf_token %} <!-- Django表单必须的安全令牌 --> {{ form.title }} {{ form.file_field }} <!-- 渲染文件上传字段，MultipleFileField将会生成相应的input元素 --> <button type="submit">上传文件</button> </form>
上面的 csrf_token django表单必须的安全令牌,form.file_field 也是我们form.py定义的批量上传字段。
打开members/urls.py，添加我们的路由
path('uploads/', views.batch_upload_view, name='upload'),
我们的批量上传功能就已经写好了，我们打开http://127.0.0.1:8000/polls/uploads/页面
填好表单，批量选择文件，点击上传，这里我只是演示，没有做页面渲染样式与字段验证，感兴趣的小伙伴可以加上自己喜欢的样式。
然后进入我们的数据库可以看到我们与上传模型的记录被添加
我们打开uploads目录，也可以看到我们上传好的文件。
需要注意的是在保存上传的文件之前，数据需要存储在某个地方。
默认情况下，如果上传的文件小于 2.5 MB，django 会将上传的全部内容保存在内存中。
这意味着保存文件仅涉及从内存读取和写入磁盘，因此速度非常快。
但是，如果上传的文件太大，django 会将上传的文件写入存储在系统临时目录中的临时文件。
例如/tmp/tmpzfp6I6.upload。如果上传的文件足够大，您可以看到该文件的大小随着 django 将数据传输到磁盘而增长
总结
文件上传算是一种很常见的需求，几乎构建很多项目系统，以及插件都需要用到。
通过上面例子可以看到django通过forms表单的形式灵活定义文件上传的页面，字段，以及数据库存储。
在实际项目中我们还要考虑到安全性，包括检查文件大小（可通过FileField的max_length属性设置）、防止路径遍历攻击。
还需注意服务器端的验证，比如检查文件类型、内容安全等。
例子里面有提到，django的FileSystemStorage和DefaultStorage类提供了基本的文件存储管理。
自定义存储后端可以提供更多灵活性，如自定义文件命名规则、存储路径等，以避免文件名冲突和优化组织结构。
大量文件上传或下载也会影响应用性能。最好采用云存储服务、内容分发网络(CDN)、以及对静态和媒体文件的有效缓存策略，可以显著提升用户体验。
对于我们本地的存储策略，需要考虑上传文件的生命周期管理，包括旧文件的定期清理策略，以避免无限制增长占用存储空间。
