Python Django中的STATIC_URL 設置和使用方式

使用Django靜態設置時，遇到很多問題，經過艱苦的Baidu, stack overflow, Django原檔閱讀，終于把靜態圖片給搞出來了。特記錄下來。

關鍵的概念：Django中，靜態資源的存放通過設置 STATIC_URL, STATICFILES_DIRS 來設置，一般STATIC_URL設置為：/static/

STATIC_URL='/static/', 這個static 是在Django 具體APP下建立的static目錄，用來存放靜態資源。而STATICFILES_DIRS一般用來設置通用的靜態資源，對應的目錄不放在APP下，而是放在Project下，例如：

STATICFILES_DIRS=（os.path.join(BASE_DIR, "common_static"),）

具體在模板文件中訪問的時候，都是統一用：/static/資源名的方式，就可以訪問到資源，不論具體的目錄是APP下的static，還是project下的common_static, 都可以用/static/資源名的方式訪問到。

為增強可移植性，在模板中可以用：STATIC_URL來代替具體的/static/來設置資源路徑，但是需要在settings.py中2個地方進行設置，否則會發生取不到資源的錯誤：

1. INSTALLED_APPS 中，加入 'django.contrib.staticfiles'

2. TEMPLATES 中，context_processors中，加入django.template.context_processors.static

模板中調用時：

<img src="{{STATIC_URL}}pic.jpg " />

補充知識：Django中static（靜態）文件詳解以及{% static %}標簽的使用

在一個網頁中，不僅僅只有一個html骨架，還需要css樣式文件，js執行文件以及一些圖片等。因此在DTL中加載靜態文件是一個必須要解決的問題。在DTL中，使用static標簽來加載靜態文件。要使用static標簽，首先需要{% load static %}。

加載靜態文件的步驟如下：

首先確保django.contrib.staticfiles已經添加到settings.INSTALLED_APPS中。

確保在settings.py中設置了STATIC_URL。

注意： 上面兩條都是在創建Django 項目的時候就自動給我們弄好了，只要我們沒有去改動它，就不用管。

在已經安裝了的app下創建一個文件夾叫做static，然后再在這個static文件夾下創建一個當前app的名字的文件夾，再把靜態文件放到這個文件夾下。例如你的app叫做book，有一個靜態文件叫做book.jpg，那么路徑為book/static/book/book.jpg。

（為什么在app下創建一個static文件夾，還需要在這個static下創建一個同app名字的文件夾呢？原因是如果直接把靜態文件放在static文件夾下，那么在模版加載靜態文件的時候就是使用book.jpg，如果在多個app之間有同名的靜態文件，這時候可能就會產生混淆。而在static文件夾下加了一個同名app文件夾，在模版中加載的時候就是使用app名/book.jpg，這樣就可以避免產生混淆。）

注意： 文件夾的名字必須為static 。

如果有一些靜態文件是不和任何app掛鉤的。即不再任何一個app的目錄下。那么可以在settings.py中添加STATICFILES_DIRS，以后DTL就會在這個列表的路徑中查找靜態文件。例如我們在manage.py的同級目錄下新建一個static的文件夾。然后在settings.py:中添加STATICFILES_DIRS

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

注：第三種和第四種方法都可以加載靜態文件，我的個人習慣是在manage.py的同級目錄下新建一個static文件夾，然后將所有的靜態文件進行分類的在里面存儲。而不去app中新建一個static的文件夾。但這只是我的個人習慣。畢竟不管是黑貓白貓，能抓到老鼠的就是好貓，所以只要我們能把項目做出來能運行，并且代碼結構有邏輯性、層次感就行了。

在模版中使用load標簽加載static標簽。比如要加載在項目的static文件夾下的style.css的文件。那么示例代碼如下：

{% load static %}

<link rel="stylesheet" href="{% static 'style.css' %}" rel="external nofollow" >

注意： {% load static %}需要放在html的頭部位置（至少在使用static標簽的上面），一般都是放在html的最上面。如果{% extend %}標簽和{% load static %}同時存在，{% extend %}需要放在最上面，然后再放{% load static %}等標簽。

如果不想每次在模版中加載靜態文件都使用load加載static標簽，那么可以在settings.py中的TEMPLATES/OPTIONS添加'builtins':[‘django.templatetags.static']，這樣以后在模版中就可以直接使用static標簽，而不用手動的load了。

注意： 位置不要添加錯誤了

TEMPLATES = [
 {
  'BACKEND': 'django.template.backends.django.DjangoTemplates',
  'DIRS': [os.path.join(BASE_DIR, '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',
   ],
   #添加在這個位置
   'builtins' : [
    'django.templatetags.static'
   ],
  },
 },
]

下面的不常用，但是可以了解一下。

如果沒有在settings.INSTALLED_APPS中添加django.contrib.staticfiles。那么我們就需要手動的將請求靜態文件的url與靜態文件的路徑進行映射了。示例代碼如下：

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

urlpatterns = [
 # 其他的url映射
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

但平時我們并不會用到這個，Django內置已經將django.contrib.staticfiles添加進去了的，我們為什么要給他刪除來自找麻煩呢？放在這里也只是提供一個參考，了解一下。

最后分享一個快捷鍵的使用：在我們寫項目的時候，有時候修改了代碼而沒有效果，這是因為瀏覽器使用的緩存加載，這個時候我們就可以使用這個快捷鍵來不使用緩存加載一個文件，來達到查看修改代碼之后的效果的目地。

ctrl+shift+r 不使用緩存加載一個文件

以上這篇Python Django中的STATIC_URL 設置和使用方式就是小編分享給大家的全部內容了，希望能給大家一個參考，也希望大家多多支持億速云。