python - Django static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) 实际上做了什么？

Question

我正在使用 Django 2.2。来自 Django 管理静态文件 documentation :

If you use django.contrib.staticfiles as explained above, runserver will do this automatically when DEBUG is set to True. If you don’t have django.contrib.staticfiles in INSTALLED_APPS, you can still manually serve static files using the django.views.static.serve() view.

This is not suitable for production use! For some common deployment strategies, see Deploying static files.

For example, if your STATIC_URL is defined as /static/, you can do this by adding the following snippet to your urls.py:

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)

Note

This helper function works only in debug mode and only if the given prefix is local (e.g. /static/) and not a URL (e.g. http://static.example.com/).

Also this helper function only serves the actual STATIC_ROOT folder; it doesn’t perform static files discovery like django.contrib.staticfiles.

我的解读

1. static是一个辅助函数，它在 开发期间 提供 STATIC_ROOT 中的文件(这是真的吗？)
2. static仅在 debug = True
时有效
3. static仅适用于像 STATIC_URL = '/static/'
这样的本地前缀
4. 当 DEBUG 设置为 True 并且我按照文档中的说明使用和设置静态文件应用程序时，如果我执行 python manage.py runserver 来启动本地服务器, 将自动处理静态文件的服务(是吗？？)

我的问题

1. 将 static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) 添加到您项目的 urls.py 究竟有什么作用？
2. static 是真的吗从 STATIC_ROOT 目录本地提供静态文件？为了测试这个理论，在运行 collectstatic 之后，我删除了 static 目录以查看静态文件是否仍然可以正常加载(从 STATIC_ROOT)，但他们没有!为什么？
3. 我如何验证 Django 是否从我的 STATIC_ROOT 位置加载静态文件...而不是我的项目和应用程序中的静态目录？
4. 如果 Django 自动提供静态文件(在文档中提到)，为什么需要将 static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) 添加到 urlpatterns？

示例

设置.py

DEBUG = True

...

INSTALLED_APPS = [
    'django.contrib.admin',
    ...
    'django.contrib.staticfiles',
    'puppies.apps.PuppiesConfig'
]

...

STATIC_URL = '/static/'

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

STATIC_ROOT = 'c:/lkdsjfkljsd_cdn'

在我所有的模板中，我都使用了{% load static %}。

然后我做:python manage.py collectstatic

此时，我的 urls.py 中是否包含以下内容似乎并不重要 - 我的静态文件仍在加载，但我不知道它们是否会加载从我项目的静态目录或我的 STATIC_ROOT (c:/lkdsjfkljsd_cdn):

if settings.DEBUG is True:
    urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

最后，如果我删除项目中的那些静态目录，所有 css、js 和图像都将不起作用，这让我相信我的 Django 项目正在从项目的静态目录而不是 STATIC_ROOT 加载静态文件。

那么，我如何告诉 Django 从我的 STATIC_ROOT 位置加载静态文件...而不是我的项目和应用程序中的静态目录？ 或者，我是否误解了 Django不应该从本地的 STATIC_ROOT 位置加载文件吗？

*编辑(添加 HTML 图像)

Answer 1

我认为你混淆了一些东西。让我澄清一下。

static:

根据文档，它提供了用于提供静态文件的 URL 模式。如果你去implementation ，然后你会看到:

return [
        re_path(r'^%s(?P<path>.*)$' % re.escape(prefix.lstrip('/')), view, kwargs=kwargs),
]

它的作用是去掉前缀左边的正斜杠(即把/static/转换成static/)，然后有一个view(是 serve ) 拉取文件的人。

serve:

此函数执行服务文件。它将提供来自文档根目录的文件。

runserver:

runserver 命令运行 django 开发服务器。如果您在 INSTALLED_APPS 中安装了 django.contrib.staticfiles，那么它将自动提供静态文件。如果您不想提供静态服务，请使用 runserver --nostatic。 collectstatic 或 STATIC_ROOT 与此命令无关。

collectstatic :

此命令收集来自不同STATIC_DIRS 的所有静态文件，并将它们放在由STATIC_ROOT 定义的文件夹中。 collectstatic 在生产部署中非常有用，当您使用 NGINX 或 Apache 等反向代理服务器时。NGINX/Apache/Varnish 使用该文件夹(collectstatic 存储静态文件的位置)作为根目录并提供静态服务从中。不建议在生产中使用 runserver。您可以使用 gunicorn/uwsgi 来为 django 提供服务。但是 gunicorn/uwsgi 不提供静态文件，因此使用反向代理服务器来提供静态文件。

最后:

回答您的问题:

1. 不，你不必把它放在你的代码中，除非你没有在你的 INSTALLED_APPS 中添加 django.contrib.staticfiles。

2. 没有

3. 你不需要。 STATIC_ROOT 用于不同的目的

4. 不是。但是为了提供 MEDIA 文件，您可以添加以下模式:

   if settings.DEBUG:
       urlpatterns += [
           re_path(r'^media/(?P<path>.*)$', serve, {
               'document_root': settings.MEDIA_ROOT,
           }),
       ]
   

在生产中，媒体文件也应该由反向代理服务器提供服务。