来源：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大咖汇特邀讲师，DAMA中国分会理事，香港金管局特聘数据管理专家，拥有丰富的行业经验。本文将从数据要素 ...
2025-04-22CDA持证人简介 刘伟，美国 NAU 大学计算机信息技术硕士， CDA数据分析师三级持证人，现任职于江苏宝应农商银行数据治理岗。 学 ...
2025-04-21持证人简介：贺渲雯 ，CDA 数据分析师一级持证人，互联网行业数据分析师 今天我将为大家带来一个关于用户私域用户质量数据分析 ...
2025-04-18一、CDA持证人介绍 在数字化浪潮席卷商业领域的当下，数据分析已成为企业发展的关键驱动力。为助力大家深入了解数据分析在电商行 ...
2025-04-17CDA持证人简介：居瑜 ，CDA一级持证人，国企财务经理，13年财务管理运营经验，在数据分析实践方面积累了丰富的行业经验。 一、 ...
2025-04-16持证人简介： CDA持证人刘凌峰，CDA L1持证人，微软认证讲师（MCT）金山办公最有价值专家（KVP），工信部高级项目管理师，拥有 ...
2025-04-15持证人简介：CDA持证人黄葛英，ICF国际教练联盟认证教练，前字节跳动销售主管，拥有丰富的行业经验。在实际生活中，我们可能会 ...
2025-04-14在 Python 编程学习与实践中，Anaconda 是一款极为重要的工具。它作为一个开源的 Python 发行版本，集成了众多常用的科学计算库 ...
2025-04-14随着大数据时代的深入发展，数据运营成为企业不可或缺的岗位之一。这个职位的核心是通过收集、整理和分析数据，帮助企业做出科 ...
2025-04-11持证人简介：CDA持证人黄葛英，ICF国际教练联盟认证教练，前字节跳动销售主管，拥有丰富的行业经验。 本次分享我将以教培行业为 ...
2025-04-11近日《2025中国城市长租市场发展蓝皮书》（下称《蓝皮书》）正式发布。《蓝皮书》指出，当前我国城市住房正经历从“增量扩张”向 ...
2025-04-10在数字化时代的浪潮中，数据已经成为企业决策和运营的核心。每一位客户，每一次交易，都承载着丰富的信息和价值。 如何在海量客 ...
2025-04-09数据是数字化的基础。随着工业4.0的推进，企业生产运作过程中的在线数据变得更加丰富；而互联网、新零售等C端应用的丰富多彩，产 ...
2025-04-094月7日，美国关税政策对全球金融市场的冲击仍在肆虐，周一亚市早盘，美股股指、原油期货、加密货币、贵金属等资产齐齐重挫，市场 ...
2025-04-08背景 3月26日，科技圈迎来一则重磅消息，苹果公司宣布向浙江大学捐赠 3000 万元人民币，用于支持编程教育。 这一举措并非偶然， ...
2025-04-07在当今数据驱动的时代，数据分析能力备受青睐，数据分析能力频繁出现在岗位需求的描述中，不分岗位的任职要求中，会特意标出“熟 ...
2025-04-03在当今数字化时代，数据分析师的重要性与日俱增。但许多人在踏上这条职业道路时，往往充满疑惑： 如何成为一名数据分析师？成为 ...
2025-04-02最近我发现一个绝招，用DeepSeek AI处理Excel数据简直太爽了！处理速度嘎嘎快！ 平常一整天的表格处理工作，现在只要三步就能搞 ...
2025-04-01你是否被统计学复杂的理论和晦涩的公式劝退过？别担心，“山有木兮：统计学极简入门（Python）” 将为你一一化解这些难题。课程 ...
2025-03-31在电商、零售、甚至内容付费业务中，你真的了解你的客户吗？ 有些客户下了一两次单就消失了，有些人每个月都回购，有些人曾经是 ...
2025-03-31
