Django 中的 STATIC_ROOT 与 STATIC_URL

Question

我对静态根感到困惑，想澄清一下。

要在 Django 中提供静态文件，settings.py 和 urls.py 中应包含以下内容：

import os
PROJECT_DIR=os.path.dirname(__file__)

1. 应收集静态文件的目录的绝对路径

STATIC_ROOT= os.path.join(PROJECT_DIR,'static_media/')

2.静态文件的 URL 前缀

STATIC_URL = '/static/'

3. 静态文件的其他位置

STATICFILES_DIRS = ( os.path.join(PROJECT_DIR,'static/'),)

...以及在 urls.py 中的以下几行：

from django.contrib.staticfiles.urls import staticfiles_urlpatterns
urlpatterns += patterns('', (
    r'^static/(?P<path>.*)$',
    'django.views.static.serve',
    {'document_root': settings.STATIC_ROOT}
))

4. 我们还使用 python manage.pycollectstatic

问题：

1. 有人可以向我解释一下工作流程吗：理想情况下事情应该怎样做。截至目前，我将上述代码片段复制/粘贴到指定位置，并继续在静态目录中创建新文件，它就可以工作了。然而，在我的 settings.STATIC_ROOT 中，我指向了另一个目录。

2. 如果有人能够解释每个设置的工作流程：如何收集和管理文件，以及遵循什么是好的做法，那就太好了。

谢谢。

Answer 1

静态根

./manage.pycollectstatic 将收集用于部署的静态文件的目录的绝对路径。
示例：STATIC_ROOT="/var/www/example.com/static/"

现在命令 ./manage.pycollectstatic 将复制所有将静态文件（即应用程序中的静态文件夹中、所有路径中的静态文件）复制到目录 /var/www/example.com/static/ 中。现在你只需要在 apache 或 nginx 等上提供这个目录。

STATIC_URL

提供STATIC_ROOT目录中的静态文件的URL（由Apache或nginx等）。
示例：/static/ 或 http://static.example.com/

如果您设置 STATIC_URL = 'http:// static.example.com/'，那么您必须通过以下方式提供 STATIC_ROOT 文件夹（即 "/var/www/example.com/static/"） url 处的 apache 或 nginx 'http://static.example.com/'（以便您可以引用静态文件'/var/www/example.com/static/jquery.js' 和 'http://static.example.com/jquery.js')

现在在您的 django-templates 中，您可以通过以下方式引用它：

{% load static %}
<script src="{% static "jquery.js" %}"></script>

它将呈现：

<script src="http://static.example.com/jquery.js"></script>

Answer 2

STATICFILES_DIRS：您可以在此处保留项目的静态文件，例如模板使用的文件。

STATIC_ROOT：将其留空，当您执行manage.pycollectstatic时，它将搜索系统上的所有静态文件并将它们移动到此处。您的静态文件服务器应该映射到该文件夹​​，无论它位于何处。运行collectstatic后检查一下，你会发现django已经构建了目录结构。

--------编辑----------------

正如@DarkCygnus所指出的，STATIC_ROOT应该指向文件系统上的一个目录，该文件夹应该是空的，因为它会由 Django 填充。

STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

或

STATIC_ROOT = '/opt/web/project/static_files'

--------结束编辑 -----------------

STATIC_URL: '/static/' 通常没问题，它只是静态文件的前缀。

Answer 3

2023 年 8 月更新：

首先，我解释一下 STATIC_ROOT，然后 [STATIC_URL2。

STATIC_ROOT 可以设置一个文件夹路径，与下面的命令一起使用，将 Django 项目中的 apps 和 admin 的静态文件收集到该文件夹​​路径中。 *STATIC_ROOT 永远不会影响 STATIC_URL：

python manage.py collectstatic 

并且 STATIC_ROOT 仅适用于生产模式，即 DEBUG = False 如下所示：

# "core/settings.py"

DEBUG = False // Production Mode

现在，我们有一个包含静态文件的 django 项目core.js 位于 core 文件夹中，其中 settings.py 位于 myapp 中code> 文件夹，它是应用程序，如下所示：

和 css、字体、< venv 文件夹中 admin 文件夹中的 code>img 和 js 文件夹如下所示。 *我为此 django 项目使用名为 venv 的虚拟环境，因此 admin 的静态文件位于其中，并且 admin 文件夹的相对路径为 venv/lib/ python3.8/site-packages/django/contrib/admin/static/admin/:

<图像src="https://i.sstatic.net/ThKL0.png" alt="在此处输入图像描述">

然后，我们设置 BASE_DIR / 'static/' ，即 <在我的例子中，Windows 上的 code>C:\Users\kai\django-project\static 为 STATIC_ROOT。此外，我们设置 DEBUG = False 因为 STATIC_ROOT 仅适用于生产模式，正如我之前所说：

# "core/settings.py"

DEBUG = False // Production Mode

STATIC_ROOT = BASE_DIR / 'static/' # Here
STATIC_URL = 'static/'

现在，我们运行以下命令：

python manage.py collectstatic 

然后、 static 文件夹已创建，并且 css、fonts、img 和 js 文件夹位于admin 文件夹** 和myapp 文件夹中的 myapp.css 被收集到 static 文件夹中，如下所示，但我们可以看到，core.jscore 文件夹中的 > 不会收集到 static 文件夹中，如下所示，因为正如我之前所说，命令 python manage.pycollectstatic 收集静态文件来自 django 项目中的应用程序和管理，但 core 文件夹其中有 settings.py 不是应用程序和管理员。这就是为什么 core 文件夹中的 core.js 没有收集到 static 文件夹中：

但是，有一种方法收集将 core 文件夹中的 core.js 复制到 static 文件夹中。为此，我们需要在 Windows 上设置 BASE_DIR / 'core/static/' ，即 C:\Users\kai\django-project\core\static案例为 STATICFILES_DIRS 中settings.py 如下所示：

# "core/settings.py"

DEBUG = False

STATICFILES_DIRS = [ # Here
    BASE_DIR / 'core/static/'
]

STATIC_ROOT = BASE_DIR / 'static/'
STATIC_URL = 'static/'

或者，我们需要将 core 设置为 INSTALLED_APPS in settings.py 如下所示：

# "core/settings.py"

DEBUG = False

INSTALLED_APPS = [
    'core', # Here
]

现在，我们再次运行以下命令：

python manage.py collectstatic 

然后，输入 yes然后按 Enter 覆盖现有 static 文件夹：

您已请求在目标位置收集静态文件
按照您的设置中的指定：

C:\Users\kai\django-project\static

这将覆盖现有文件！您确定要这样做吗？

输入“是”继续，或输入“否”取消：是

现在，core 文件夹中的 core.js 被收集到 static 文件夹中，如下所示如下所示：

接下来，我解释一下 STATIC_URL。

STATIC_URL 可以将静态文件 URL 的前目录部分设置在静态文件 URL 的主机部分和文件部分之间，如下所示。 *STATIC_URL 永远不会影响 STATIC_ROOT：

       |     Host      |   Directory    |  File  |
       |               |Front |  Back   |        |
        <-------------> <----> <-------> <------>      
https://www.example.com/static/admin/css/base.css

例如，我们在 中将 'static/' 设置为 STATIC_URL settings.py 如下所示。 *STATIC_URL 在开发模式（即 DEBUG = True）和生产模式（即 DEBUG = False：

# "core/settings.py"

DEBUG = False

STATICFILES_DIRS = [
    BASE_DIR / 'core/static/'
]

STATIC_ROOT = BASE_DIR / 'static/'
STATIC_URL = 'static/' # Here

然后，打开 Django Admin：

然后，按F12打开开发者工具从Sources检查当前打开的Django管理页面使用的资源，并且有我们刚刚收集到static文件夹中的管理静态文件：

然后，将鼠标悬停在 css 中的 base.css 以检查 URL：

正如我们所见，我们可以设置前面的目录部分 static：

                       Here  
                     <------>
http://localhost:8000/static/admin/css/base.css

并且，下面的 URL 是 www.example.com 和 https：

                         Here
    　　　　　　　　　　　<------>
https://www.example.com/static/admin/css/base.css

并且，我们可以更改前面的目录部分 静态到hello/world。

因此，只需将 STATIC_URL 从 'static/' 更改为 'hello/world/' ，如下所示：

# "core/settings.py"

DEBUG = False

STATICFILES_DIRS = [
    BASE_DIR / 'core/static/'
]

STATIC_ROOT = BASE_DIR / 'static/'
STATIC_URL = 'hello/world/' # Here

然后，刷新 Django 管理页面：

然后，将前面目录部分static改为hello/world，如下所示：

                         Here  
                     <----------->
http://localhost:8000/hello/world/admin/css/base.css

Answer 4

上面的所有答案都有帮助，但没有解决我的问题。在我的生产文件中，我的 STATIC_URL 是 https:///static 并且我在我的 dev settings.py 文件中使用了相同的 STATIC_URL。

这会导致 django/conf/urls/static.py 中出现静默失败。

测试 elif 不是 settings.DEBUG 或前缀中的 '://'：
选取 URL 中的“//”，但不添加静态 URL 模式，导致找不到静态文件。

如果 Django 吐出一条错误消息，指出您不能使用 http(s):// 和 DEBUG = True

我必须将 STATIC_URL 更改为'/静止的/'

Answer 5

在 Django 3.1+ 之后，目录路径的配置略有变化，但概念当然是相同的。

STATICFILES_DIRS

STATICFILES_DIRS = [
    BASE_DIR / 'static',
    BASE_DIR / 'app_1/static',
    BASE_DIR / 'app_2/static',
]

顾名思义，它是一个目录列表。它用于为静态文件指定多个目录。对于应用程序的可重用性而言最有用。每个应用程序都有其独立的目录，而不是为所有静态文件提供一个目录。就像每个单独应用程序的模板一样。

配置应用程序的静态文件目录：

=> my_app
    => static
        => my_app
            => css
            => js

在开发模式下，使用命令python manage.py runserver，Django使用STATICFILES_FINDERS设置搜索静态文件。默认情况下，它尝试在 STATICFILES_DIRS 设置中列出的文件夹中查找请求的静态文件。如果失败，Django 会尝试使用 django.contrib.staticfiles.finders.AppDirectoriesFinder 来查找文件，该文件会在项目中每个已安装应用程序的静态文件夹中查找。

STATIC_ROOT

STATIC_ROOT = BASE_DIR / 'static'

它是 python manage.pycollectstatic 收集用于部署的静态文件的目录的绝对路径。示例：

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

对于开发来说，没有必要配置STATIC_ROOT，但对于生产来说却极其重要。这是Nginx、Apache服务器访问网站静态文件时要考虑的路径。

STATIC_URL

引用位于 STATIC_ROOT 中的静态文件时使用的 URL。示例：“static/”或“http://static.example.com/”

STATIC_URL = '/static/'

现在，假设我决定配置 STATIC_URL='/asset/'，那么我需要更改 STATIC_ROOT=BASE_DIR / 'asset' 并且我的目录名称也应该是 asset。

参考：

https://docs.djangoproject.com/en/4.0/ref /contrib/staticfiles/