Django中static（静态）文件详解以及{% static %}标签的使用

关注

转载最新推荐文章于 2026-10-06 10:36:08 发布 1.6k 阅读 AI 写同款· GEO 优化 ›

Django静态文件加载失败？手把手教你解决MIME type ‘text/html‘报错问题本文深入解析了Django开发中常见的静态文件加载失败问题，特别是因MIME类型错误导致的‘text/html’报错。文章从问题根源入手，详细对比了开发与生产环境的不同配置方案，提供了从settings.py核心配置检查、Nginx服务器设置到使用Django Debug Toolbar进行高级调试的完整解决方案，帮助开发者彻底根治静态文件服务配置问题。阅读详情

想要深入学习Django的可以看一些这个视频：超细讲解Django打造大型企业官网

在一个网页中，不仅仅只有一个html骨架，还需要css样式文件，js执行文件以及一些图片等。因此在DTL中加载静态文件是一个必须要解决的问题。在DTL中，使用static标签来加载静态文件。要使用static标签，首先需要{% load static %}。

加载静态文件的步骤如下：
首先确保django.contrib.staticfiles已经添加到settings.INSTALLED_APPS中。
确保在settings.py中设置了STATIC_URL。
注意：上面两条都是在创建Django 项目的时候就自动给我们弄好了，只要我们没有去改动它，就不用管。
在已经安装了的app下创建一个文件夹叫做static，然后再在这个static文件夹下创建一个当前app的名字的文件夹，再把静态文件放到这个文件夹下。例如你的app叫做book，有一个静态文件叫做book.jpg，那么路径为book/static/book/book.jpg。

（为什么在app下创建一个static文件夹，还需要在这个static下创建一个同app名字的文件夹呢？原因是如果直接把静态文件放在static文件夹下，那么在模版加载静态文件的时候就是使用book.jpg，如果在多个app之间有同名的静态文件，这时候可能就会产生混淆。而在static文件夹下加了一个同名app文件夹，在模版中加载的时候就是使用app名/book.jpg，这样就可以避免产生混淆。）
注意：文件夹的名字必须为static 。

如果有一些静态文件是不和任何app挂钩的。即不再任何一个app的目录下。那么可以在settings.py中添加STATICFILES_DIRS，以后DTL就会在这个列表的路径中查找静态文件。例如我们在manage.py的同级目录下新建一个static的文件夹。然后在settings.py:中添加STATICFILES_DIRS

STATICFILES_DIRS = [
	os.path.join(BASE_DIR,"static")
]

注：第三种和第四种方法都可以加载静态文件，我的个人习惯是在manage.py的同级目录下新建一个static文件夹，然后将所有的静态文件进行分类的在里面存储。而不去app中新建一个static的文件夹。但这只是我的个人习惯。毕竟不管是黑猫白猫，能抓到老鼠的就是好猫，所以只要我们能把项目做出来能运行，并且代码结构有逻辑性、层次感就行了。

在模版中使用load标签加载static标签。比如要加载在项目的static文件夹下的style.css的文件。那么示例代码如下：

{% load static %}

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

注意： {% load static %}需要放在html的头部位置（至少在使用static标签的上面），一般都是放在html的最上面。如果{% extend %}标签和{% load static %}同时存在，{% extend %}需要放在最上面，然后再放{% load static %}等标签。

如果不想每次在模版中加载静态文件都使用load加载static标签，那么可以在settings.py中的TEMPLATES/OPTIONS添加’builtins’:[‘django.templatetags.static’]，这样以后在模版中就可以直接使用static标签，而不用手动的load了。
注意： 位置不要添加错误了

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates')]
        ,
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
            #添加在这个位置
            'builtins' : [
                'django.templatetags.static'
            ],
        },
    },
]

下面的不常用，但是可以了解一下。
如果没有在settings.INSTALLED_APPS中添加django.contrib.staticfiles。那么我们就需要手动的将请求静态文件的url与静态文件的路径进行映射了。示例代码如下：

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

urlpatterns = [
	# 其他的url映射
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)