Django 5实用指南（十）静态文件与媒体文件管理

网络风云

于 2025-02-28 14:15:00 发布

阅读量1.6w

点赞数 23

CC 4.0 BY-SA版权

文章标签： python django 后端

本文链接：https://blog.csdn.net/weixin_42998312/article/details/145687891

在 Web 开发中，静态文件（如 CSS、JavaScript、图片等）和媒体文件（如用户上传的文件）是不可或缺的组成部分。Django 提供了强大的工具来管理这些文件，使得在开发和生产环境中都能轻松处理静态和媒体文件的上传、存储和访问。

本章将详细介绍如何在 Django5 中配置和管理静态文件与媒体文件，包括静态文件的管理、文件上传处理、静态文件的路径配置和如何在模板中引用静态文件等。

10.1 静态文件的配置与管理

静态文件是指那些在应用程序运行时不会发生变化的文件，如 CSS、JavaScript 和图片等。Django 提供了一个专门的机制来管理这些静态文件。

10.1.1 配置静态文件

在 Django 中，静态文件的路径由 STATIC_URL 和 STATICFILES_DIRS 设置来决定。首先，确保在 settings.py 文件中正确配置静态文件的相关设置。

# settings.py

# 设置静态文件的URL路径，静态文件将从该路径提供服务
STATIC_URL = '/static/'

# 设置静态文件目录，Django 会自动查找这些目录中的静态文件
STATICFILES_DIRS = [
    BASE_DIR / "static",  # 项目根目录下的static目录
]

# 配置静态文件的存储路径
STATIC_ROOT = BASE_DIR / "staticfiles"  # 生成的静态文件会被收集到该目录

STATIC_URL：设置静态文件的访问路径，在生产环境中，静态文件将通过该路径提供服务。
STATICFILES_DIRS：这是一个列表，用来配置额外的静态文件目录，Django 会从这些目录中收集静态文件。
STATIC_ROOT：用于指定静态文件收集的目标目录，执行 collectstatic 命令时，所有静态文件会被收集到此目录。

10.1.2 在模板中引用静态文件

Django 提供了 {% static %} 标签来引用静态文件，在模板中使用时需要先加载 static 模块。

<!-- 在HTML模板中引用静态文件 -->

{% load static %}

<!DOCTYPE html>
<html>
    <head>
        <link rel="stylesheet" href="{% static 'css/styles.css' %}">
    </head>
    <body>
        <script src="{% static 'js/script.js' %}"></script>
        <img src="{% static 'images/logo.png' %}" alt="Logo">
    </body>
</html>

{% static 'path' %}：使用 {% static %} 标签来引用静态文件。传入静态文件相对于静态目录的路径。

10.1.3 使用 collectstatic 收集静态文件

在生产环境中，Django 不会直接提供静态文件，而是使用 collectstatic 命令将所有静态文件集中到 STATIC_ROOT 指定的目录中。这些文件通常由 Web 服务器（如 Nginx）提供服务。

# 收集所有静态文件

python manage.py collectstatic

collectstatic：此命令会扫描 STATICFILES_DIRS 中的所有静态文件，并将它们收集到 STATIC_ROOT 目录下。

10.1.4 静态文件的版本控制

为了避免浏览器缓存问题，Django 在生产环境中会对静态文件进行版本控制。在生成静态文件时，Django 会为每个文件生成一个哈希值，这样文件名就会包含唯一的标识符，确保用户每次访问的都是最新的文件。

# 在模板中引用静态文件时，Django 会自动为文件加上版本号

{% static 'css/styles.css' %}

Django 会自动为静态文件生成包含哈希值的文件名，如 styles.abc123.css。

10.2 媒体文件的配置与管理

媒体文件是指用户上传的文件，例如图片、视频、音频等。Django 提供了一个专门的机制来处理这些文件的上传、存储和访问。

10.2.1 配置媒体文件

在 settings.py 文件中，配置媒体文件的存储路径和访问 URL。

# settings.py

# 设置媒体文件的访问URL

MEDIA_URL = '/media/'

# 设置媒体文件的存储路径

MEDIA_ROOT = BASE_DIR / 'media'

MEDIA_URL：设置媒体文件的访问路径，用于访问用户上传的文件。
MEDIA_ROOT：设置媒体文件的存储路径，所有上传的文件将存储在此目录下。

10.2.2 处理文件上传

Django 提供了 FileField 和 ImageField 来处理文件和图片上传。以下是一个简单的模型示例，展示了如何处理文件上传。

# models.py
from django.db import models

class Profile(models.Model):
    name = models.CharField(max_length=100)

    avatar = models.ImageField(upload_to='avatars/')

    resume = models.FileField(upload_to='resumes/')

    def __str__(self):
        return self.name

ImageField：用于处理图片上传，upload_to 参数指定文件上传的路径。
FileField：用于处理其他类型的文件上传，upload_to 参数也用于指定文件上传的路径。

10.2.3 配置文件上传视图

在视图中，我们可以通过 request.FILES 来访问用户上传的文件，并将其保存到数据库中。

# views.py
from django.shortcuts import render
from .forms import ProfileForm

def upload_profile(request):
    if request.method == 'POST' and request.FILES:

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

        if form.is_valid():
            form.save()

            return HttpResponse('Profile uploaded successfully!')
    else:
        form = ProfileForm()

    return render(request, 'upload_profile.html', {'form': form})

request.FILES：通过 request.FILES 获取上传的文件。

10.2.4 在模板中显示媒体文件

在模板中，我们可以通过 {% MEDIA_URL %} 标签来显示用户上传的媒体文件。

<img src="{{ user.profile.avatar.url }}" alt="Avatar">

user.profile.avatar.url：通过 .url 属性获取上传文件的 URL 路径。

10.2.5 配置 URL 路由来提供媒体文件

在开发环境中，Django 会自动处理媒体文件的访问。我们只需在 urls.py 中添加相应的配置：

# urls.py
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    path('admin/', admin.site.urls),

    # 其他 URL 配置
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

static：这是 Django 提供的一个工具，用于将媒体文件的 URL 映射到实际的文件路径。

10.3 上传限制与安全性

Django 提供了一些安全性和限制措施来避免不必要的风险，如限制上传文件的大小、文件类型等。

10.3.1 限制上传文件类型

你可以在表单中使用 FileField 或 ImageField 限制上传文件的类型。例如，限制只能上传图片：

# forms.py
from django import formsfrom .models import Profile

class ProfileForm(forms.ModelForm):
    class Meta:

        model = Profile

        fields = ['name', 'avatar', 'resume']

    def clean_avatar(self):
        avatar = self.cleaned_data.get('avatar')

        if avatar:
            if avatar.size > 5 * 1024 * 1024:  # 限制头像大小为5MB

                raise forms.ValidationError('Avatar file is too large. Max size is 5MB.')

            if not avatar.name.endswith('.jpg') and not avatar.name.endswith('.png'):

                raise forms.ValidationError('Only JPG and PNG images are allowed.')

        return avatar

clean_avatar：在表单中通过自定义验证方法来限制文件的类型和大小。

10.3.2 限制上传文件大小

可以在 settings.py 中配置最大上传文件大小限制：

# settings.py

MAX_UPLOAD_SIZE = 5 * 1024 * 1024 # 5MB

然后在表单中进行限制。

10.4 小结

本章详细介绍了 Django5 中静态文件与媒体文件的管理，包括如何配置静态文件的路径、如何上传和处理用户媒体文件、如何在模板中引用这些文件。通过配置静态文件和媒体文件的相关设置，开发者可以方便地管理静态资源并提供良好的文件上传体验。同时，Django 也提供了强大的安全性和文件类型限制功能，帮助开发者防范文件上传相关的风险。