Django的STATIC_URL与STATIC_ROOT与STATICFILES_DIRS详解

680 阅读2分钟

Django的STATIC_URL与STATIC_ROOT与STATICFILES_DIRS详解

大致了解

#locate the common static files
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'common_static')
]
​
STATIC_DIRS = [
    BASE_DIR / 'common_static'
]
#the dir for command "python manage.py collectstatic"
STATIC_ROOT = os.path.join(BASE_DIR, "static_dict")
​
STATIC_ROOT = BASE_DIR / 'static_dict'
# URL of browser accessing static file
STATIC_URL = '/static_dict/'

STATICFILES_DIRS

作用

Django如果有多个App应用,可以把几个应用的静态文件放到一个公共的目录。

STATICFILES_DIRS就是设置这个共用目录的,让应用程序先到STATICFILES_DIRS设置的共用目录里查找,如果没找到再去STATIC_ROOT设置的目录查找。

调试环境下(DEBUG =True)

在开发阶段Django把/static 映射到django.contrib.staticfiles这个App,django.contrib.staticfiles自动地从STATICFILES_DIRS、STATIC_ROOT以及各个App的static子目录里面搜索静态文件。

生产环境下(DEBUG =False)

一旦部署到开发环境上,settings.py不需要重新编写(因为进行了静态文件收集),只要在Nginx的配置文件里面写好映射,/static/将会被Nginx处理。

django.contrib.staticfiles虽然仍然存在,但因为不会接收到以/static/开始的路径,所以将不会产生作用。不必担心Django会使处理速度变慢。

当settings.DEBUG is False的时候,staticfiles将自动关闭。

STATIC_ROOT

作用

是项目部署的时候才会用到的,是配合Nginx使用的。他的作用就是收集(复制)每个App下static中静态资源以及项目common_static中的静态资源到STATIC_ROOT对应的static_dict文件夹中(static_dict可以指定为其他名字,但是需要跟STATIC_URL相同)。使用python manage.py collectstatic来做这一步操作。所以STATIC_ROOT 与 STATICFILES_DIRS的路径不能重复。

STATIC_URL

作用

Django通过STATIC_URL配置映射,让浏览器可以直接访问静态文件。

举例

STATIC_URL = '/static_dict/'
# 项目名叫webproject,下面有个叫web的app

调试模式下

在浏览器上输入:

http://127.0.0.1:8000/static_dict/images/1.png

那么就相当与访问:(自动地从STATICFILES_DIRS、各个App的static子目录里面搜索静态文件。 )

/home/webproject/web/static/images/1.png

生产模式下

在浏览器上输入:

http://www.xxxxx.com/static_dict/images/1.png

那么就相当与访问:(因为进行了静态文件收集,只会在STATIC_ROOT 中搜索文件)

/www/webproject/web/static_dict/images/1.png

\