Django4 静态文件 404|极客教程

Django4 静态文件 404

静态文件在 Web 开发中起着至关重要的作用，包括 CSS、JavaScript 和图片等静态资源。在 Django4 中，处理静态文件依然是一个常见的问题，尤其是当我们在开发中遇到静态文件 404 错误时，可能会让我们感到困惑。本文将详细介绍 Django4 中处理静态文件 404 的方法，希望能够帮助大家更好地解决这个问题。

设置静态文件路径

在 Django4 中，我们需要在 settings.py 中配置静态文件的路径。打开 settings.py 文件，找到 STATIC_URL 和 STATIC_ROOT 两个配置项，分别设置静态文件的 URL 和静态文件的根目录。

# settings.py
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

上面的配置中，STATIC_URL 表示静态文件访问的 URL，一般默认为 "/static/"。STATIC_ROOT 则表示静态文件的根目录，一般为项目的根目录下的 staticfiles 文件夹。

在模板中引入静态文件

在 Django4 的模板中，我们可以通过 {% static %} 模板标签来引入静态文件。例如，我们有一个 index.html 文件，并且在其中引入了一个 CSS 文件 style.css，那么可以使用以下方式引入静态文件：

<!DOCTYPE html>
<html>
<head>
    <title>My Website</title>
    <link rel="stylesheet" href="{% static 'style.css' %}">
</head>
<body>
    <h1>Welcome to my website!</h1>
</body>
</html>

在这个示例中，{% static 'style.css' %} 表示引入名为 style.css 的静态文件。在实际开发中，我们可以将 CSS、JavaScript、图片等静态资源放置在 staticfiles 文件夹下的相应目录中。

静态文件 404 错误解决方法

当我们在开发中遇到静态文件 404 错误时，可能是由于路由配置不正确或者静态文件路径不正确导致的。下面分别给出两种解决方法：

方法一：使用 `django.contrib.staticfiles.urlpatterns.staticfiles_urlpatterns`

在 urls.py 文件中，我们可以使用 django.contrib.staticfiles.urlpatterns.staticfiles_urlpatterns 来配置静态文件的路由。例如，我们可以在 urls.py 中添加以下代码：

# urls.py
from django.urls import path
from django.contrib.staticfiles.urls import staticfiles_urlpatterns

urlpatterns = [
    path('', views.index, name='index'),
    # other urls here
]

urlpatterns += staticfiles_urlpatterns()

这样配置后，Django4 会自动处理静态文件的路由，确保静态文件能够被正确加载。

方法二：手动配置静态文件路由

如果不想使用 django.contrib.staticfiles.urlpatterns.staticfiles_urlpatterns，也可以手动配置静态文件的路由。在 urls.py 文件中添加以下代码：

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

urlpatterns = [
    path('', views.index, name='index'),
    # other urls here
]

if settings.DEBUG:
    urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

这样配置后，当 DEBUG 开关为 True 时，Django4 会自动处理静态文件的路由。

运行示例代码

为了验证上述两种方法的效果，我们可以创建一个简单的 Django4 项目，并在模板中引入静态文件。首先，在项目目录下创建一个名为 static 的文件夹，并在其中创建一个名为 style.css 的样式文件。

/* static/style.css */
h1 {
    color: red;
}

接下来，在项目的 templates 目录下创建一个 index.html 文件，并在其中引入上面创建的样式文件。

<!DOCTYPE html>
<html>
<head>
    <title>My Website</title>
    <link rel="stylesheet" href="{% static 'style.css' %}">
</head>
<body>
    <h1>Welcome to my website!</h1>
</body>
</html>

然后，按照上述两种方法在 urls.py 中配置静态文件路由。最后，启动 Django4 项目，并访问首页页面，查看静态文件是否被正确加载。

以下是示例代码的运行结果：