如何在 Django 中加载和使用静态文件？

在 Django 中，静态文件是指与应用程序相关的文件，如 CSS、JavaScript、图像和 HTML 模板。静态文件可以帮助您为您的应用程序添加更多的功能和美观性。

在这篇文章中，我们将学习如何加载和使用 Django 中的静态文件。我们将讨论 Django 中的静态文件目录结构、如何设置静态文件目录、如何在 HTML 模板中加载静态文件以及如何在视图中处理静态文件。

Django 中的静态文件目录结构

在默认情况下，Django 会在每个应用程序下创建一个名为 “static” 的目录。这是存储与应用程序相关的静态文件的推荐位置。每个应用程序只需在其静态文件目录中创建一个子目录，以便 Django 将其静态文件分组。

以下是 Django 中默认的静态文件目录结构：

your_app/
    __init__.py
    admin.py
    apps.py
    models.py
    tests.py
    views.py
    static/
        your_app/
            css/
                style.css
            js/
                script.js
            img/
                logo.png
    templates/
        your_app/
            base.html
            index.html

在此结构中，应用程序的静态文件位于 static/your_app/ 子目录下，其中包含 css/，js/ 和 img/ 子目录。您可以根据需要添加其他子目录。

在 Django 中设置静态文件目录

要在 Django 中使用静态文件，需要在 settings.py 文件中指定静态文件目录。打开 settings.py 文件并将以下代码添加到底部：

STATIC_URL = '/static/'
STATICFILES_DIRS = [BASE_DIR / 'static']

在上面的代码段中，我们已经指定了一个 BASE_DIR，这是 Django 项目的根路径。这里，我们添加了一个名为 static 的子目录，以便 Django 能够找到我们的静态文件。

注意，STATIC_URL 变量指定了我们应该从哪里访问静态文件。在我们的例子中，我们访问静态文件的 URL 将为 http://localhost:8000/static/，其中 localhost 是我们正在运行的服务器的名称，8000 是 Web 服务器端口号。

在 HTML 模板中加载静态文件

接下来，我们将在 HTML 模板中加载静态文件。要加载 CSS 文件，请打开您的 HTML 模板，并按以下方式添加以下代码：

{% load static %}
<link rel="stylesheet" href="{% static 'your_app/css/style.css' %}">

在上面的代码中，我们首先使用 {% load static %} 标记加载模板标记，以便在模板中使用 Django 的 static 标签。

然后我们使用 href="{% static 'your_app/css/style.css' %}" 的方式链接静态文件。其中，your_app 缩写代表您的应用程序名称，css/style.css 是所需静态文件的相对路径。

要引用 JavaScript 文件，请按以下方式添加以下代码：

{% load static %}
<script src="{% static 'your_app/js/script.js' %}"></script>

在上面的代码中，我们使用 script 标记来链接 JavaScript 文件。注意，在这里我们不需要指定 rel 属性。

在视图中处理静态文件

在视图中处理静态文件意味着您希望读取或写入静态文件。要处理静态文件，我们需要导入以下 Django 模块：

import os
from django.conf import settings
from django.http import HttpResponse
from django.views import View

然后，我们可以使用下面的代码自定义一个视图来处理静态文件：

class StaticFileView(View):
    def get(self, request, filename):
        filepath = os.path.join(settings.STATICFILES_DIRS[0], filename)
        with open(filepath, 'rb') as f:
            response = HttpResponse(f.read(), content_type='application/octet-stream')
            response['Content-Disposition'] = 'inline; filename=' + os.path.basename(filepath)
            return response

在上面的代码中，我们定义了一个名为 StaticFileView 的视图，它采用 filename 参数作为输入，并将其用作要读取的静态文件的名称。

然后，我们使用 os.path.join() 函数构建静态文件的完整路径，并使用该路径打开文件。我们使用 HttpResponse 类从文件读取内容并构建响应对象。最后，我们在响应对象中设置了 Content-Disposition 头以使浏览器将其解释为嵌入式对象。

现在，我们已经介绍了在 Django 中加载和使用静态文件的方法。使用这些简单的步骤，您可以开始将自己的 CSS、JavaScript 和图像添加到 Django 应用程序中，以使其更加完整。