Django Academy · 课时

MEDIA_ROOT 与文件上传

Q: 「MEDIA_ROOT 与文件上传」这节课中我会学到什么？

接收并存储用户上传的文件 你通过在浏览器中直接运行的动手代码来练习 Django Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

接收并存储用户上传的文件

第 3 / 4 课13 个步骤

MEDIA_ROOT 与文件上传 是 CoddyKit 上的免费 Django Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Django Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Django Academy 课程共包含 4 节课。

静态文件与媒体文件

静态文件随代码一起发布。媒体文件则是在运行时由用户上传的文件，例如头像或文档，因此需要单独的存放位置。

MEDIA_ROOT 设置

MEDIA_ROOT 是磁盘上用于保存 Django 接收的所有上传文件的绝对路径。它位于源代码目录树之外。

MEDIA_ROOT = BASE_DIR / 'media'

MEDIA_URL 设置

MEDIA_URL 是浏览器请求上传文件时使用的公共前缀，就像 STATIC_URL 用于静态资源一样。

MEDIA_URL = '/media/'

添加 FileField

要接受上传文件，请为模型添加 FileField。Django 会将文件保存到磁盘，并只将其路径保存在数据库中。

class Resume(models.Model):
    doc = models.FileField(upload_to='resumes/')

upload_to 路径

upload_to 参数表示 MEDIA_ROOT 下的子文件夹。您可以使用它整理上传文件，例如将所有简历放在一起。

动态 upload_to

当路径需要根据实例变化时，可以向 upload_to 传入一个函数，例如按用户分别存放文件。

def user_dir(instance, filename):
    return f'user_{instance.user.id}/{filename}'

表单需要 enctype

上传文件的 HTML 表单必须将 enctype 设置为 multipart/form-data，否则浏览器根本不会发送文件数据。

<form method="post" enctype="multipart/form-data">

读取 request.FILES

上传的文件数据不会到达 request.POST，而是会存放在 request.FILES 中。您需要将它传入表单以绑定这些数据。

form = ResumeForm(request.POST, request.FILES)

获取 URL

保存后，每个文件字段都会提供一个 .url 属性，用于生成可以放入模板的 MEDIA_URL 链接。

<a href="{{ resume.doc.url }}">Download</a>

验证上传文件

切勿信任原始上传文件。请在表单的 clean 方法中限制文件大小和类型，避免恶意文件进入系统。🔒

保持媒体文件私有

MEDIA_ROOT 应位于代码仓库之外，并且绝不能由 collectstatic 提供。用户文件和代码应始终清晰分开。

快速检查

让我们检查一下上传的文件数据会在视图中的哪里到达。

在交互式课程中回答

回顾

您了解到，MEDIA_ROOT 用于存储用户上传的文件，FileField 配合 upload_to 可以整理这些文件，而 request.FILES 携带文件数据。📁

免费开始

用 AI 导师学习 Python — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 30
课程: 120

免费开始学习查看完整课程

常见问题解答

「MEDIA_ROOT 与文件上传」课时是免费的吗？

是的 — 「MEDIA_ROOT 与文件上传」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Django Academy 课程的其余内容，请升级到 CoddyKit PRO。 Django Academy 课程共包含 4 节课。

「MEDIA_ROOT 与文件上传」这节课中我会学到什么？

接收并存储用户上传的文件你通过在浏览器中直接运行的动手代码来练习 Django Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Django Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Django Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「MEDIA_ROOT 与文件上传」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Django Academy 课中编写并运行代码吗？

能。每节 Django Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Django Academy