Django 知识库：管理静态文件

5268 views, 2020/05/20 updated Go to Comments

Django 水友群里问得最多的，就是找不到静态文件的问题了，各种姿势的 404 not found 层出不穷。

到底应该怎么管理静态文件，请看下面的解答，希望对你有帮助。

Django Version >= 3.0

开发阶段

方案一

首先请保证打开调试模式：

# settings.py

DEBUG = True

开发阶段时这个选项通常都是 True ，以便获得框架提供的 Debug 功能。

然后请确保注册了如下应用：

# settings.py

INSTALLED_APPS = [
    ...
    'django.contrib.staticfiles',
    ...
]

这是 Django 内置的也是默认注册的 App，功能是帮你管理静态文件。

接下来，还需要配置这些：

# settings.py

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

这样就可以了，你甚至都不需要配置专门的路由，因为 contrib.staticfiles 帮你搞好了。

接下来就可以创建 static/ 目录，并且把静态文件都放到这个目录下。注意这个 static/ 目录直接位于项目的根目录下，与 templates/ 、以及其他你创建的 app 是同一级的。

然后就可以愉快的在模板中引用静态文件了，比如：

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

<script src="{% static 'world.js' %}"></script>

<img src="{% static 'hexie.png' %}" alt="">

方案二

另一个种方法是不依赖 contrib.staticfiles ，手动给静态文件提供服务：

# settings.py

INSTALLED_APPS = [
    ...
    # 注释掉它
    # 'django.contrib.staticfiles',
    ...
]

DEBUG = True

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static')
# 注释掉它
# STATICFILES_DIRS = [os.path.join(BASE_DIR, "static")]

所以此时你需要手动添加静态文件的路由解析：

# urls.py

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

urlpatterns = [
    ...
]
urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)