Django部署时静态文件配置的坑

Django部署时静态文件配置配置的坑

近期有个需求是用django进行开发部署，结果发现静态文件配置的坑是真的多，另外网上很多的内容也讲不清楚原理，就是这样这样，又那样那样，进了不少坑，这里记录一下关于css,img,js这些静态文件的坑。

正确配置

这里先上正确的配置，感兴趣或者遇到问题了可以仔细往下看各种坑的情况。

1、项目setting.py的配置

DEBUG=True
1

改为

DEBUG=False
1

把原先的

STATIC_URL = '/static/'
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]
1
2

改为

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static')
1
2

此处介绍一下我的项目结构

static目录下面

2、项目urls.py的配置

注意是项目下的，不是app下面的哈！！！！！！因为太多的文章不标明，我当时写到app下的urls.py去导致正常开发好的HTML页面根本加载不了上面那些静态文件！

方法1

from django.views.static import serve
from django.cong import settings
from django.cong.urls import url


urlpatterns = [
...
# 加在里面
url(r"^static/(?P.*)$", serve, {"document_root": settings.STATIC_ROOT}, name='static')
]
1
2
3
4
5
6
7
8
9
10

方法2

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

urlpatterns = [
...
]+static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
1
2
3
4
5
6

注意两处只是方法不同，仔细看一下，其实改的是相同的配置，就是把静态文件的根目录加入到要部署的Django环境中

2、静态文件的收集

注意此处不是所有项目都需要的哈，这也是很多人没有写清楚的一点是，下面这个命令是用来将静态文件收集到指定的目录中，在上面的代码配置下，所有的静态文件将会收集到我项目的static文件中（主要是admin页面的img,css,js等等，会从Django的库目录收集到我们的项目目录中），但是因为我的项目并没有用到admin页面的相关内容，而是自己写了HTML和样式表等各种静态文件，所以我可以不执行，但是部署的话，如果有需要用到admin页面的相关内容，就要执行，上代码！

python manage.py collectstatic
1

未说明的 一些坑

1、静态文件被收集到项目所在的磁盘static目录下

例如D盘，D:\static,因为不少博主在写的时候说

os.path.join(BASE_DIR, '/static'）# 错误
os.path.join(BASE_DIR, '/static/'）# 正确
1
2

但这其实就是个坑，会把项目所有用到的静态文件移动到D:\static下面，因为join函数的第二个函数如果是‘/’开头的话，就会忽略掉前面的内容，直接就是项目所在的磁盘下直接建立static文件了，这个可以在setting中把配
置给print出来看到。正确的就是

os.path.join(BASE_DIR, 'static'）
1

只是呢，STATICFILES_DIRS这个配置需要注释掉， 这个是在调试的时候声明的环境，会把里面的内容打包到STATIC_ROOT的环境中，因此没有注释的话还会报错说STATIC_ROOT不能出现在STATICFILES_DIRS中，结合上面的join的坑，这里真的是待了半天多，害。

2、补充一下运行上面 python manage.py collectstatic的结果

正确的情况下，收集到是什么样子的。

其中1是从Django库里收集来的，2是我自己写的，如果用了Django中比较多的模版作为自己的开发静态文件，迁移过来使用就是必须要的。

补充一下静态文件没能成功加载的情况

是的，就是Django账号密码登录后的默认首页，没有静态文件装饰是真的臭！