Django静态文件与媒体文件配置详解

Noah

发布时间：2026-10-14 | 3人浏览过

原创

本文详细解析Django项目中静态文件与媒体文件的配置方法。涵盖开发环境下的STATIC_URL设置、模板引用及调试模式下的serve视图使用，以及生产环境中collectstatic命令的应用。同时介绍MEDIA_ROOT与MEDIA_URL的配置，实现用户上传文件的存储与访问，帮助开发者完善Django文件管理流程。

Django静态文件配置

静态文件管理

静态文件（static files）通常指网页开发中所需的CSS样式表、JavaScript脚本以及图像资源等文件。

在开发阶段，配置静态文件需遵循以下步骤：

首先，在项目的settings配置文件中，确保INSTALLED_APPS列表内包含'django.contrib.staticfiles'应用。

其次，将STATIC_URL变量设置为'/static/'，作为静态文件的URL前缀。

接着，将特定应用所需的静态文件放置在该应用的static目录下，例如路径为my_app/static/my_app，具体文件如my_app/static/my_app/my_image.jpg。

虽然可以直接将文件放在my_app/static根目录下，但如果不同应用中存在同名静态文件，这种做法会导致冲突，因此建议按应用子目录存放。

在模板中引用静态文件时，需使用Django的模板标签。


{% load static %}
<img src="{% static 'my_app/myexample.jpg' %}" alt="My image"/>

若存在不属于特定应用的通用静态文件，可创建独立的static文件夹存放，并在settings中进行相应配置。


STATICFILES_DIRS = (
  os.path.join(BASE_DIR, "static"),
  '/var/www/static/',
)

完成上述配置后，在开发环境中，只要settings.DEBUG设置为True，运行runserver命令即可直接访问静态文件。

如果INSTALLED_APPS中未包含'django.contrib.staticfiles'，则需手动在urls.py中调用django.contrib.staticfiles.views.serve()视图来处理静态文件请求。


from django.conf import settings
from django.contrib.staticfiles import views
 
if settings.DEBUG:
  urlpatterns += [
    url(r'^static/(?P<path>.*)$', views.serve),
  ]

或者采用另一种配置方式。


from django.conf import settings
from django.conf.urls.static import static 
urlpatterns = [
  # ... the rest of your URLconf goes here ...
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

需要注意的是，上述开发环境下的配置仅在DEBUG设置为True时生效。

进入生产环境后，建议配置反向代理服务器直接提供静态文件服务。此时需将静态文件收集至代理服务器可访问的目录，并在settings中设置STATIC_ROOT。


STATIC_ROOT = "/var/www/example.com/static/"

随后执行以下命令：


python manage.py collectstatic

该命令会将各个应用内的静态文件以及STATICFILES_DIRS指定的目录中的文件，统一收集到STATIC_ROOT指定的目录中，交由Apache或Nginx等服务器进行管理。

Django媒体文件配置

媒体文件管理

媒体文件（Media files）指用户通过Model中的FileField或ImageField上传的文件。

假设存在如下Model定义：


from django.db import models 
class Car(models.Model):
  name = models.CharField(max_length=255)
  price = models.DecimalField(max_digits=5, decimal_places=2)
  photo = models.ImageField(upload_to='cars')

在settings中设置MEDIA_ROOT为os.path.join(BASE_DIR, 'media')，用于指定存储用户上传文件的本地目录。

同时设置MEDIA_URL为'/media/'，为MEDIA_ROOT目录下的文件生成URL地址前缀。

当创建Car实例时，其ImageField字段指定的图片将自动存储到media/cars文件夹中。


>>> car = Car.objects.get(name="57 Chevy")
>>> car.photo
<ImageFieldFile: chevy.jpg>
>>> car.photo.name
u'cars/chevy.jpg'
>>> car.photo.path
u'/media/cars/chevy.jpg'
>>> car.photo.url
u'/media/cars/chevy.jpg'

在模板中展示图片时，需引用正确的媒体文件路径。


<img src="{{ car.photo.url }}" alt="My image"/>

为使媒体文件在开发环境中可访问，需在urls.py中配置django.contrib.staticfiles.views.serve()视图。


from django.conf import settings #from myapp import settings
from django.conf.urls.static import static
 
urlpatterns = patterns('',
  # ... the rest of your URLconf goes here ...
) + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

通过上述配置，即可正常使用媒体文件。

以上内容涵盖了Django中静态与媒体文件的核心配置，希望对读者有所帮助。