1. Django 静态文件分类

Django 静态文件分为两类：static 和 media。

• static： 是页面引用的 JS、CSS、Image 等文件
• media：是用户上传的文件

2. 生产环境配置

生产环境，通常配置 Nginx 转发静态文件请求，而 Django 处理动态请求。

nginx 配置

1
2
3
4
5
6
7

location /media  {
    alias /path/to/project/media;
}

location /static {
    alias /path/to/project/static;
}

在部署时，需要执行 python manage.py collectstatic 命令将 INSTALLED_APPS 列表内的全部 Django App 的静态资源收集到 STATIC_ROOT 指定的目录。

3. 开发环境配置

3.1 配置和使用

第一步，在 INSTALLED_APPS 中加入 ‘django.contrib.staticfiles’

第二步，在 urls.py 中新增如下路由，仅在 settings.DEBUG==True 时生效，正式环境使用 Nginx 转发。

1
2
3
4
5
6
7
8

if settings.RUN_MODE == 'DEVELOP':
    urlpatterns += patterns('',
                            url(r'^media/(?P<path>.*)$', 'django.views.static.serve', {
                                'document_root': settings.MEDIA_ROOT,
                            }),
                            url(r'^static/(?P<path>.*)$', 'django.views.static.serve',
                                {'document_root': settings.STATIC_ROOT}),
                            )

第三步，在 settings 文件 TEMPLATES - OPTIONS - context_processors 配置中添加

1
2

django.template.context_processors.static
django.template.context_processors.media

第四步，在模板中使用 STATIC_URL、MEDIA_URL 变量

static 文件

1
2
3
4

<img src="{{STATIC_URL}}test.png>
#  或者
{% load staticfiles %}
<img src="{% static 'img/logo.png' %}">

media 文件

1

<source src="{{ MEDIA_URL }}movie.ogg" type="video/ogg" />

3.2 处理流程

第一步，Django 收到一个静态文件的请求，例如，/static/css/main.css

第二步，Django 在 STATICFILES_DIRS 中寻找 css/main.css 这个文件

如果第二步找到了，直接返回该文件，否则在 INSTALLED_APPS 列表内全部 Django App 的 static 目录下继续查找。

4. static 相关变量

4.1 STATIC_ROOT

指定执行 python manage.py collectstatic 命令时，静态文件存储的目录

4.2 STATIC_URL

URL 映射，指定静态目录的 URL，默认值为：

4.3 STATICFILES_DIRS

STATICFILES_DIRS 是一个列表，指定工程里哪些目录存放了静态文件。

4.4 STATICFILES_STORAGE

使用 python manage.py collectstatic 命令收集静态文件时，Django 使用的文件存储引擎。如果需要将静态文件托管在其他地方，那么需要修改 STATICFILES_STORAGE 参数，实现相应的方法即可。默认值为：

1

STATICFILES_STORAGE = 'django.contrib.staticfiles.storage.StaticFilesStorage'

4.5 STATICFILES_FINDERS

在开发环境下 django.contrib.staticfiles 查找静态资源的顺序取决于 STATICFILES_FINDERS 的配置，STATICFILES_FINDERS 默认配置如下：

1
2
3
4

STATICFILES_FINDERS = (
    'django.contrib.staticfiles.finders.FileSystemFinder',
    'django.contrib.staticfiles.finders.AppDirectoriesFinder',
)

• django.contrib.staticfiles.finders.FileSystemFinder 用来从 STATICFILES_DIRS 指定的路径中查找静态文件
• django.contrib.staticfiles.finders.AppDirectoriesFinder 是从 INSTALLED_APPS 列表内全部 Django App 的 static 目录中查找静态文件

5.1 MEDIA_ROOT

MEDIA 存储的是用户上传的文件，比如在 Model 里面的FileField 的文件。如果定义MEDIA_ROOT=C:\media，那么 File = models.FileField(upload_to='file/')，上传的文件就会被保存到 C:\media\file

在 settings 里面设置的 MEDIA_ROOT必须是绝对路径，可以这样写：

1
2
3

PROJECT_ROOT = os.path.dirname(os.path.abspath(__file__))
PROJECT_DIR, PROJECT_MODULE_NAME = os.path.split(PROJECT_ROOT)
MEDIA_ROOT = os.path.join(PROJECT_DIR, 'media/')

5.2 MEDIA_URL

MEDIA_URL 是指从浏览器访问时的 URL 前缀，例如：

1
2

MEDIA_ROOT='C:\media\'
MEDIA_URL='/mymedia/'

当浏览器访问：http://localhost/mymedia/1.png 就是访问 c:\media\1.png

6. 参考

• http://www.jianshu.com/p/727dc7631274