Django 如何在 Django 中设置静态文件

在本文中，我们将介绍如何在 Django 中设置静态文件。

阅读更多：Django 教程

什么是静态文件

静态文件是指网站或应用程序中不需要动态生成的文件，例如样式表（CSS）、JavaScript 文件、图像文件等。静态文件存储在服务器上，并被直接从服务器返回给用户的浏览器。

Django 静态文件配置

在 Django 中，配置静态文件分为两个步骤：设置静态文件的存放路径和设置静态 URL。

设置静态文件的存放路径

在 Django 项目中，通常会有一个名为 static 的文件夹，用于存放静态文件。在项目的根目录下创建 static 文件夹，并将相应的静态文件放入其中。

假设我们有一个样式表文件 style.css，我们将其放在 static/css 目录下。

设置静态 URL

在 Django 中，要设置静态文件的 URL，需要在项目的配置文件中进行配置。打开项目的 settings.py 文件，找到 STATIC_URL 设置，将其设置为 '/static/'。

STATIC_URL = '/static/'

这样，我们就设置好了静态 URL。

引用静态文件

在模板或视图中引用静态文件时，可以使用 Django 的模板标签 static。

在模板文件中，使用 {% load static %} 导入静态文件模板标签。然后，可以使用 static 标签引用静态文件。

{% load static %}

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

这样，style.css 文件就会被正确引用。

配置静态文件访问权限

在部署 Django 项目时，需要确保静态文件可以被正确访问。可以使用 Django 自带的 django.contrib.staticfiles 中间件来处理静态文件。

在项目的 settings.py 文件中，找到 MIDDLEWARE 设置，确保 django.contrib.staticfiles 中间件被添加到中间件列表中。

MIDDLEWARE = [
    ...
    'django.contrib.staticfiles.middleware.StaticFilesMiddleware',
    ...
]

这样，静态文件就能够被正确访问。

配置其他静态文件设置

除了配置静态文件的存放路径和 URL，Django 还提供了其他一些配置选项。

配置静态文件存放路径

如果希望将静态文件存放在其他位置，可以在项目的 settings.py 文件中设置 STATICFILES_DIRS。

例如，将静态文件存放在项目根目录的 assets 文件夹中：

STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'assets'),
]

这样，Django 会在 assets 文件夹中查找静态文件。

静态文件缓存

Django 提供了一个静态文件处理器，可以将静态文件的 URL 路径中添加一个哈希值，用于版本控制和缓存策略。

在项目的 settings.py 文件中，找到 STATICFILES_STORAGE 设置，将其设置为 django.contrib.staticfiles.storage.ManifestStaticFilesStorage。

这样，Django 会在静态文件的 URL 路径中添加一个哈希值，以确保每次静态文件更新后都有一个唯一的 URL。

STATICFILES_STORAGE = 'django.contrib.staticfiles.storage.ManifestStaticFilesStorage'

示例

下面是一个示例，展示了如何在 Django 中设置和引用静态文件。

项目结构

myproject/
    ├── myapp/
    │   ├── templates/
    │   ├── static/
    │       ├── css/
    │           ├── style.css
    ├── myproject/
    │   ├── settings.py
    │   ├── urls.py
    ├── manage.py

设置静态文件的存放路径

将样式表文件 style.css 放在 static/css 目录下。

设置静态 URL

在项目的 settings.py 文件中，将 STATIC_URL 设置为 '/static/'。

引用静态文件

在模板文件中，使用 {% load static %} 导入静态文件模板标签。然后，可以使用 static 标签引用静态文件。

{% load static %}

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

总结

本文介绍了在 Django 中设置静态文件的步骤。首先需要设置静态文件的存放路径，并在项目的配置文件中设置静态 URL。然后，在模板或视图中使用 static 标签引用静态文件。另外，还介绍了如何配置静态文件的访问权限以及其他静态文件设置选项。

通过正确设置和引用静态文件，可以使网站或应用程序的样式和行为更为丰富和吸引人。