来源：AirPython
作者：星安果
大家好，我是安果！
文件上传、下载作为基础功能，在 Web 项目中非常普遍，Django 项目如何实现文件上传下载？
本篇文章将带大家 5 分钟快速实现文件上传下载功能
详细实现步骤如下（ 9 步）
2-1.进入虚拟环境，创建一个项目及 App
workon django3
# 创建项目
django-admin startproject file_up_and_down_demo
# 进入项目根目录
cd file_up_and_down_demo/
# 创建一个App
django-admin startapp index
2-2.创建模板目录并配置 settings.py
在 index App 下创建一个 templates 文件夹，然后在项目配置文件 settings.py 中配置 App 及模板目录
# settings.py
# 配置App
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'
django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'
django.contrib.staticfiles',
'index',
]
TEMPLATES = [
{
'BACKEND': '
django.template.backends.django.DjangoTemplates',
'DIRS': [
# 配置模板目录
os.path.join(BASE_DIR, 'index/templates')
],
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'
django.template.context_processors.debug',
'
django.template.context_processors.request',
'
django.contrib.auth.context_processors.auth',
'
django.contrib.messages.context_processors.messages',
],
},
},
]
2-3.创建文件模型，并映射到数据库
以默认的 sqlite 为例，在 index App 下的 models.py 中自定义一个代表文件的模型
该模型包含 3 个字段：
# index App models.py
from django.db import models
from django.utils import timezone
# 文件模型
class FileModel(models.Model):
# 文件名称
name = models.CharField(max_length=50)
# 文件保存路径
path = models.CharField(max_length=100)
# 上传时间
upload_time = models.DateTimeField(default=timezone.now)
然后，在项目根目录下执行下面 2 条命令，将模型结构映射到数据库中
# 数据库映射
Python3 manage.py makemigrations
python3 manage.py migrate
2-4.自定义表单控件
在 index App 下创建一个表单文件 forms.py
在内部自定义一个表单类，继承于 forms.Form
# index App forms.py
from django import forms
class FileForm(forms.Form):
file = forms.FileField(
# 支持多文件上传
widget=forms.ClearableFileInput(attrs={'multiple': True}),
label='请选择文件',
)
2-5.添加上传、下载路由 URL
为上传、下载功能添加路由 URL
# 项目urls.py
from django.contrib import admin
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
path('', include('index.urls'))
]
# index App urls.py
from django.urls import path
from .views import *
urlpatterns = [
# 上传
path('', index_view, name='index'),
# 下载
path('download/<id>', download_view, name='download')
]
2-6.编写模板文件
在 index App 的模板文件夹创建一个简单的模板文件 upload.html
其中
# index App upload.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>主页-上传文件</title>
</head>
<body>
<form method="post" enctype="multipart/form-data">
{% csrf_token %}
{{ form.as_p }}
<input type="submit" value="确定上传">
</form>
</body>
</html>
2-7.上传视图函数
在 index App 下的 views.py 中编写上传功能的视图函数
需要注意的是，我们需要提前在项目根目录创建一个 upload 文件夹，用于存放上传的文件
# index App views.py
def index_view(request):
"""
上传文件
:param request:
:return:
"""
if request.method == 'POST':
form = FileForm(request.POST, request.FILES)
if form.is_valid():
# 选择的文件
files = request.FILES.getlist('file')
# 遍历写入到数据库中
for file in files:
# 写入到数据库中
file_model = FileModel(name=file.name, path=os.path.join('./upload', file.name))
file_model.save()
# 写入到服务器本地
destination = open(os.path.join("./upload", file.name), 'wb+')
for chunk in file.chunks():
destination.write(chunk)
destination.close()
# 提示上传成功
return HttpResponse('上传成功!')
else:
form = FileForm()
return render(request, 'upload.html', locals())
2-8.下载视图函数
接着，编写下载功能的视图函数
# index App views.py
def download_view(request, id):
"""
下载文件
:param request:
:param id:文件id
:return:
"""
file_result = FileModel.objects.filter(id=id)
# 如果文件存在，就下载文件
if file_result:
file = list(file_result)[0]
# 文件名称及路径
name = file.name
path = file.path
# 读取文件
file = open(path, 'rb')
response = FileResponse(file)
# 使用urlquote对文件名称进行编码
response['Content-Disposition'] = 'attachment;filename="%s"' % urlquote(name)
return response
else:
return HttpResponse('文件不存在!')
2-9.运行并测试
运行项目，访问下面的地址，并上传一个文件
使用 Pycharm 打开 sqlite 数据库，发现成功插入一条文件记录，并且文件也上传到 upload 文件夹下
接着访问下面的地址实现文件下载功能「 其中，file_id 代表文件的 id 值 」
文章通过一个简单的例子实现了文件的上传、下载功能，并同步文件记录到数据库
实际项目中，一般还包含文件列表、文件删除等功能，这些功能只需要结合数据库来增删查改即可实现
数据分析咨询请扫描二维码
若不方便扫码，搜微信号：CDAshujufenxi
CDA 数据分析师：就业前景广阔的新兴职业 在当今数字化时代，数据已成为企业和组织决策的重要依据。数据分析师作为负责收集 ...
2025-06-30探秘卷积层：为何一个卷积层需要两个卷积核 在深度学习的世界里，卷积神经网络（CNN）凭借其强大的特征提取能力 ...
2025-06-30探索 CDA 数据分析师在线课程：开启数据洞察之旅 在数字化浪潮席卷全球的当下，数据已成为企业决策、创新与发展的核心驱 ...
2025-06-303D VLA新范式！CVPR冠军方案BridgeVLA，真机性能提升32% 编辑：LRST 【新智元导读】中科院自动化所提出BridgeVLA模型，通过将 ...
2025-06-30LSTM 为何会产生误差？深入剖析其背后的原因 在深度学习领域，LSTM（Long Short-Term Memory）网络凭借其独特的记忆单元设 ...
2025-06-27LLM进入拖拽时代！只靠Prompt几秒定制大模型，效率飙升12000倍 【新智元导读】最近，来自NUS、UT Austin等机构的研究人员创新 ...
2025-06-27探秘 z-score：数据分析中的标准化利器 在数据的海洋中，面对形态各异、尺度不同的数据，如何找到一个通用的标准来衡量数据 ...
2025-06-26Excel 中为不同柱形设置独立背景（按数据分区）的方法详解 在数据分析与可视化呈现过程中，Excel 柱形图是展示数据的常用工 ...
2025-06-26CDA 数据分析师会被 AI 取代吗？ 在当今数字化时代，数据的重要性日益凸显，数据分析师成为了众多企业不可或缺的角色 ...
2025-06-26CDA 数据分析师证书考取全攻略 在数字化浪潮汹涌的当下，数据已成为企业乃至整个社会发展的核心驱动力。数据分析师作 ...
2025-06-25人工智能在数据分析的应用场景 在数字化浪潮席卷全球的当下，数据以前所未有的速度增长，传统的数据分析方法逐渐难以满足海 ...
2025-06-25评估模型预测为正时的准确性 在机器学习与数据科学领域，模型预测的准确性是衡量其性能优劣的核心指标。尤其是当模型预测结 ...
2025-06-25CDA认证：数据时代的职业通行证 当海通证券的交易大厅里闪烁的屏幕实时跳动着市场数据，当苏州银行的数字金融部连夜部署新的风控 ...
2025-06-24金融行业的大数据变革：五大应用案例深度解析 在数字化浪潮中，金融行业正经历着深刻的变革，大数据技术的广泛应用 ...
2025-06-24Power Query 中实现移动加权平均的详细指南 在数据分析和处理中，移动加权平均是一种非常有用的计算方法，它能够根据不同数据 ...
2025-06-24数据驱动营销革命：解析数据分析在网络营销中的核心作用 在数字经济蓬勃发展的当下，网络营销已成为企业触达消费者 ...
2025-06-23随机森林模型与 OPLS-DA 的优缺点深度剖析 在数据分析与机器学习领域，随机森林模型与 OPLS-DA（正交偏最小二乘法判 ...
2025-06-23CDA 一级：开启数据分析师职业大门的钥匙 在数字化浪潮席卷全球的今天，数据已成为企业发展和决策的核心驱动力，数据分析师 ...
2025-06-23透视表内计算两个字段乘积的实用指南 在数据处理与分析的过程中，透视表凭借其强大的数据汇总和整理能力，成为了众多数据工 ...
2025-06-20CDA 一级考试备考时长全解析，助你高效备考 CDA（Certified Data Analyst）一级认证考试，作为数据分析师领域的重要资格认证， ...
2025-06-20
京公网安备 11010802034615号
经营许可证编号：京B2-20210330
