Django STATIC_URL 的理解

最新推荐文章于 2025-05-23 12:34:55 发布

luo_xinyu

最新推荐文章于 2025-05-23 12:34:55 发布

阅读量6.1k

点赞数 9

CC 4.0 BY-SA版权

分类专栏： django 文章标签： django

本文链接：https://blog.youkuaiyun.com/qq_24551305/article/details/84865025

django 专栏收录该内容

10 篇文章

订阅专栏

本文详细解析Django框架中静态文件的配置与引用机制，包括STATIC_ROOT、STATICFILES_DIRS、STATIC_URL的设置，以及如何在模板中正确使用静态资源。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

# the settings above
# STATIC SETTINGS
STATIC_URL = '/static/'
# BASE_DIR 是项目的绝对地址
STATIC_ROOT = os.path.join(BASE_DIR, 'collect_static')
#以下不是必须的  各个app共用的文件可以放在这
STATICFILES_DIRS = (
    os.path.join(BASE_DIR, 'common_static'),
)

# 这四个都可以定位到文件
{% load staticfiles %}  
    <img src="{% static 'img/1.png' %}" />
    <img src="{% static 'img/3.png' %}" />

    <img src="{{STATIC_URL}}img/1.png" />
    <img src="{{STATIC_URL}}img/3.png" />

一、各个路径文件夹的作用

1.STATIC_ROOT 是在部署的时候才发挥作用,执行 python managy.py collectstatic ，会在工程文件下生成(STATIC_ROOT )文件夹，把各个app下的静态文件收集到这个目录下。当然，需要配置Nginx。

2.STATICFILES_DIRS

静态文件的一般安放位置有两种:

(1).一种就是在每个app里面新建一个static文件夹，将静态文件放到里面，在加载静态文件时，比如要在模板中用到静态文件，django会自动在每个app里面搜索static文件夹(所以，不要把文件夹的名字写错，否则django就找不到你的文件夹)。

(2).另一种,就是在所有的app文件外面，建立一个公共的文件夹,，也就是我们的STATICFILES_DIRS。因为有些静态文件不是某个app独有的,那么就可以把它放到一个公共文件夹里面，方便管理(注意，建立一个公共的静态文件的文件夹只是一种易于管理的做法，但是不是必须的，app是可以跨app应用静态文件的，因为最后所有的静态文件都会在STATIC_ROOT里面存在)
那现在的问题是如何让django知道你把一些静态文件放到app以外的公共文件夹中呢，那就需要配置STATICFILES_DIRS了

二、明白Django静态文件的引用：

在static标签中引用文件时有两个查找路径：1、app下的static。2、工程下的commen_static（STATICFILES_DIRS）。

STATICFILES_DIRS告诉django,首先到STATICFILES_DIRS里面寻找静态文件,其次再到各个app的static文件夹里面找(注意，django查找静态文件是惰性查找，查找到第一个，就停止查找了)

三、STATIC_URL

那么到此为止，静态文件的机制就可以运作了，但是有一个问题,我能不能通过url直接访问我在项目中的静态文件。但是，你在浏览器访问，你不可能输入你的静态文件的本地绝对地址吧，比如我的一种图片的本地地址为

home/blogproject/common_static/img/1.png
那么别人不可能在浏览器上直接输入:
http://127.0.0.1:8000/home/blogproject/common_static/img/1.png
这样子，浏览器会报错,，没有该页面
那么django是如何让浏览器也可以访问服务器上的静态文件呢，前面已经说了，直接访问服务器本地的地址是不行的，那就需要一个映射，django利用STATIC_URL来让浏览器可以直接访问静态文件，比如：

STATIC_URL = '/static/'
那么可以在浏览器上输入:

http://127.0.0.1:8000/static/img/1.png
http://127.0.0.1:8000/static/img/3.png
那么就相当与访问：

/home/blogproject/common_static/img/1.png

/home/blogproject/mytest/static/img/3.png

也就是说STATIC_URL = '/static/' 可以定位到各个app下的staic/和工程下的commen_static/。

所以在浏览器上，利用前缀 STATIC_URL的具体内容，来映射app下的static和STATICFILES_DIRS，
http://127.0.0.1:8000/static/ 相当于本地地址的app/static 和 STATICFILES_DIRS

三、一般我们在模板中使用

<img src="{% static 'img/1.png' %}" />

我们在模板中添加一行 {% load staticfiles %}，告诉django模板引擎我们要在模板中使用静态文件。这样，便可以使用static模板标签引入静态目录中的文件。 static 'img/1.png' 告诉django，我们要显示目录名中img/1.png 的文。static标签会在img/1.png前加上STATIC_URL的指定URL，得到/static/img/1.png 。django模板引擎生成如下html

<img src="/static/img/1.png" />

如果使用

    <img src="{{STATIC_URL}}img/3.png" />

需要在setting.py中添加些设置：

1. INSTALLED_APPS 中，加入 'django.contrib.staticfiles' ，这个一般都有。

2. TEMPLATES 中，context_processors中，加入django.template.context_processors.static

参考:

https://blog.youkuaiyun.com/jj546630576/article/details/78606531

https://blog.youkuaiyun.com/wilde_lf/article/details/79402661