Django 在生产环境中服务静态文件教程

在本文中，我们将介绍如何在Django生产环境中服务静态文件。静态文件是指CSS文件、JavaScript文件、图像文件等，它们通常不包含动态内容，因此可以被直接供给给用户。在开发阶段，Django自动为我们处理静态文件，但在生产环境中，我们需要手动配置Django来服务静态文件。

阅读更多：Django 教程

配置静态文件路径

首先，我们需要在Django的设置文件中配置静态文件路径。打开settings.py文件，找到STATIC_URL和STATIC_ROOT两个设置项。

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

STATIC_URL代表静态文件的URL前缀，我们可以自定义为任意值，通常使用/static/。

STATIC_ROOT代表静态文件的根目录，这里使用了os.path.join(BASE_DIR, 'static')来生成根目录路径。我们可以根据实际情况选择不同的路径，但是需要确保该路径存在。

收集静态文件

当我们在本地开发环境中运行Django项目时，静态文件是由Django自动处理的。但是在生产环境中，我们需要手动收集静态文件到指定的静态文件根目录。

在终端中进入Django项目根目录，运行以下命令：

python manage.py collectstatic

该命令会从每个已安装的应用程序收集静态文件，并将其复制到指定的静态文件根目录中。这样，在服务器上运行Django时，可以直接提供静态文件。

配置静态文件URL

收集静态文件后，我们还需要在Django的URL配置中指定静态文件的URL。在urls.py文件中添加以下代码：

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

urlpatterns = [
    # ...其他URL配置...
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

这段代码使用static函数将静态文件URL与静态文件根目录关联起来。这样，当访问静态文件URL时，Django将直接提供对应的静态文件。

示例说明

假设我们的项目包含一个名为myapp的应用程序，并有一个static文件夹来存放静态文件。

在myapp应用程序中创建一个名为styles.css的CSS文件，内容如下：

body {
  background-color: #f2f2f2;
  font-family: Arial, sans-serif;
}

接下来，在myapp应用程序的模板文件中引用该CSS文件：

<!DOCTYPE html>
<html>
<head>
  <!-- 引用CSS文件 -->
  <link rel="stylesheet" type="text/css" href="{{ STATIC_URL }}styles.css">
</head>
<body>
  <h1>Hello, Django!</h1>
</body>
</html>

然后运行collectstatic命令，将静态文件收集到指定的静态文件根目录。

最后，配置URL，以便Django可以正确提供静态文件。在urls.py文件中添加上述的URL配置代码。

现在，在生产环境中运行Django项目时，可以访问/static/styles.css来获取该CSS文件。

总结

在本文中，我们介绍了在Django生产环境中服务静态文件的步骤。首先，需要在Django的设置文件中配置静态文件路径。然后，使用collectstatic命令将静态文件收集到指定的静态文件根目录中。最后，通过URL配置，让Django可以正确提供静态文件。通过以上步骤，我们可以在生产环境中轻松地服务静态文件。