python - Django 不在 DEBUG 中提供 STATIC_ROOT

Question

我正在使用 Python 3.5 和 Django 1.10 来运行开发服务器:

./manage.py runserver 0.0.0.0:8000

在我的 settings.py我有:

DEBUG       = True
STATIC_ROOT = os.path.join(BASE_DIR, 'static')
STATIC_URL  = '/static/'

还有一个 app目录，带有 static其静态文件的子目录:

proj/
    proj/
        ...
    app/
        static/
            a.txt
        ...
    static/
        b.txt

相当标准。

但是:Django 不提供 STATIC_ROOT什么时候DEBUG = True 。它返回 app/static/a.txt对于 /static/a.txt好吧，但不是static/b.txt对于 /static/b.txt .

改变 settings.py阅读:

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

有效 - 但我必须注释掉 STATIC_ROOT (否则 Django 会提示它不能在 STATICFILES_DIRS 中)。

现在，我不能只是“使用不同的外部静态目录”，例如static2 ，因为我正在使用 django-sass-processor ，编译.sass文件到.css文件，并把这些 .css STATIC_ROOT 中的文件(正如我所说，这是无法访问的)。

我尝试过的事情:

1. 设置 NGINX 为该目录提供服务(就像在生产环境中一样)。可行，但必须有另一种方式。

2. 配置 django-sass-processor写 .css文件放入所述“不同的外部静态目录”，例如static2 , 并将其包含在 STATICFILES_DIRS 中.同样，可行，但它不能那么复杂!

3. 在 urls.py 中手动添加静态文件 URL :

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

   这是一段很长的旅程，所以我想我应该分享它来省去其他人的麻烦:事实证明 Django 无论如何都会这样做，并且实际上覆盖 我的网址 - 但正如我所说，它仅包括我的应用程序的静态目录和 STATICFILES_DIRS 中的那些.

   我什至改变了DEBUG至 False并删除了 if - 但那也没有用，因为那时 django.conf.urls.static.static函数实际上返回一个空列表。所以，我自己使用 django.views.static.serve 实现了它，它终于成功了，但又一次——我必须关闭调试并手动实现服务静态文件，这没有意义。

更新

1. 如果您正在使用 django-sass-processor并遇到类似的问题，他们实际上提供了我刚刚在他们的文档中注意到的解决方案:一个特殊的静态查找器，您可以添加到您的 settings.py 中像这样:

   STATICFILES_FINDERS = [
       'django.contrib.staticfiles.finders.FileSystemFinder',
       'django.contrib.staticfiles.finders.AppDirectoriesFinder',
       'sass_processor.finders.CssFinder',
   ]
   

   (前两个是 Django 的默认查找器，因此当您覆盖此配置时，您应该手动包含它们)。

   但即使是现在，除了 .css 之外的任何文件，STATIC_ROOT实际上是唯一无法通过 /static/ 访问的静态目录，我觉得很奇怪。所以，我还是想解决(或者至少理解...)它。

Answer 1

乍一看，Django 不提供来自 STATIC_ROOT 的文件似乎很奇怪，但当您考虑 Django 用于静态文件的工作流时，它就有意义了。 Django 希望您将静态文件与应用程序捆绑在一起，并将项目级静态文件保存在一个单独的目录中，该目录已 checkin 版本控制。然后，当您运行 manage.py collectstatic 时，STATICFILES_FINDERS 用于将所有文件收集到一个目录中(该目录不应该在版本控制)，以便它们可以部署到 AWS S3 或其他任何地方。

所以静态文件查找器有两个工作:

1. 通过路径查找文件，用于DEBUG模式静态文件服务
2. 列出所有可用的文件，用于collectstatic

如果您能够在 STATICFILES_DIRS 中包含 STATIC_ROOT，那么 collectstatic 命令可能会陷入循环。此外，Django 开发人员不打算让您将文件保存在 STATIC_ROOT 中，因为它不应被纳入版本控制。

但是，有时您确实想要从 STATIC_ROOT 提供文件。在我的例子中，我有一个 Celery 任务，它创建上传图像的缩略图并将它们保存到静态文件存储中。在生产环境中，最终会在可以提供服务的 AWS S3 上节省开支。

因此，如果您有从 STATIC_ROOT 提供文件的有效用例，只需定义您自己的文件查找器并将其路径添加到 STATICFILES_FINDERS:

from django.contrib.staticfiles.finders import BaseFinder
from django.contrib.staticfiles.storage import staticfiles_storage

class StaticRootFinder(BaseFinder):
    """
    For debug mode only. Serves files from STATIC_ROOT.
    """
    def find(self, path, all=False):
        full_path = staticfiles_storage.path(path)
        if staticfiles_storage.exists(full_path):
            return [full_path] if all else full_path
        return []

    def list(self, ignore_patterns):
        return iter(())