Django 如何查找静态文件和模板

Django 是如何查找静态文件和模板的？

Django 查找静态文件是在模板文件中，查找模板是在视图函数中，模板在加载时会渲染变量以及请求静态文件。

比如本博客的博文详情查询逻辑：

class PostDetailView(CommonViewMixin, DetailView):
    """
    博文详情的查询逻辑
    - 继承了 ``CommonViewMixin``，会返回侧边栏和导航栏数据
    - 此外还要返回博文详情数据
    - 最后渲染到 ``blog/detail.html`` 模板中
    """
    # TODO 检索模型的配置项(~ 表示该类继承的父类)，来自 DetailView ~ BaseDetailView ~ SingleObjectMixin
    queryset = Post.get_all()
    context_object_name = "post" # 这个名称是模板在解析数据时所使用的变量
    pk_url_kwarg = "post_id"

    # TODO 模板渲染的配置项，来自 DetailView ~ SingleObjectTemplateResponseMixin ~ TemplateResponseMixin
    template_name = "blog/detail.html"

在视图函数中，将最终要渲染的模板文件配置为 blog/detail.html，这是对应静态文件目录中的 blog 目录下的 detail.html 文件。

对应的文件目录为：

├── manage.py
└── typeidea
    ├── themes
    │   ├── bootstrap
    │   │   └── templates
    │   │       ├── blog
    │   │       │   ├── base.html
    │   │       │   ├── detail.html   <---- 这里
    │   │       │   └── list.html

在这里，检索文件是从 typeidea/typeidea/themes/bootstrap/templates/ 开始的。

以及博文详情的模板：

<!-- 代码高亮插件 -->
{% block extra_head %}
    <link rel="stylesheet" type="text/css" href="{% static 'css/googlecode.min.css' %}"/>
    <script src="{% static 'js/highlight.min.js' %}"></script>
    <script>hljs.highlightAll();</script>
{% endblock %}

在模板中，将要读取的代码高亮插件 googlecode.min.css 路径配置为 {% static 'css/googlecode.min.css' %}。

对应的文件目录为：

├── manage.py
└── typeidea
    │   ├── bootstrap
    │   │   ├── static
    │   │   │   ├── css
    │   │   │   │   ├── bootstrap.css
    │   │   │   │   ├── default.min.css
    │   │   │   │   ├── googlecode.min.css
    │   │   │   │   └── prism.css
    │   │   │   └── js
    │   │   │       ├── highlight.min.js
    │   │   │       ├── prism.js
    │   │   │       └── run_prettify.js

在这里，检索文件是从 typeidea/typeidea/themes/bootstrap/ 开始的。

在 Django 的配置文件中：

# manage.py 同级目录
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

BASE_DIR 是 manage.py 同级目录。

# 页面主题切换
THEME = 'bootstrap'
# 模板
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'themes', THEME, 'templates')], <---- 这里
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

模板的目录是 BASE_DIR/themes/bootstrap/templates ，即 typeidea/typeidea/themes/bootstrap/templates/，所以可知，视图函数是从这个配置读取模板文件的目录的。

继续看静态文件配置：

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

其中 STATIC_URL 是说，页面请求静态文件要单独发起一个请求，这时候要指定一个路由名称，这里指定为 /static/，访问时的链接为 http://127.0.0.1:8000/static/googlecode.min.css。

STATICFILES_DIRS 则是服务接到请求后，要从哪个目录去找对应的文件，这里配置的是 BASE_DIR/themes/bootstrap/static，即typeidea/typeidea/themes/bootstrap/static/。

综上所述，Django 查找模板依赖于配置 TEMPLATES，查找静态文件依赖于配置 STATIC_URL 和 STATICFILES_DIRS。