关于django-debug-toolbar的一二三

django-debug-toolbar 是一个可视化的django调试工具，可以方便快捷的帮助我们查看当前请求/相应的各种调试信息。

安装

$ pip install django-debug-toolbar

django settings.py配置

INSTALL_APPS 配置
将debug_toolbar添加到 INSTALL_APPS 中

INSTALL_APPS = [
    ......
   'debug_toolbar',
]

MIDDLEWARE 配置

MIDDLEWARE = [
   ......
   'debug_toolbar.middleware.DebugToolbarMiddleware',  # debug_toolbar
]

INTERNAL_IPS 配置
在settings.py文件中添加INTERNAL_IPS 配置

INTERNAL_IPS = ['127.0.0.1', ]  # 若本机调试，ip添加为127.0.0.1

基础url配置

在项目根目录下的url.py添加配置

urlpatterns = [
    url(r'^test/', include('app_test.urls')),
]

if settings.DEBUG:
    import debug_toolbar
    urlpatterns.append(url(r'^__debug__/', include(debug_toolbar.urls)))

使用

重启服务，输入地址，即可看到如下的菜单

常见问题

访问速度慢

启用debug_toolbar后网页加载变得很慢，这是因为debug_toolbar需要jquery文件，默认情况下debug_toolbar会从google引用jquery，这就很尴尬了，解决方法如下。

下载jquery-3.3.1.min.js，然后放到项目的static静态资源文件夹下面，然后在setttings.py中：

# JQUERY_URL对应的地址映射到项目中jquery文件的位置
DEBUG_TOOLBAR_CONFIG = {'JQUERY_URL': '/static/js/jquery-3.3.1.min.js'}

Nginx转发请求后debug_toolbar不显示

使用nginx转发请求后，debug_toolbar加载不出来，这是因为nginx会从项目的静态资源文件中引用debug_toolbar需要的静态资源，而这些资源却是放在debug_toolbar的安装目录下面的，这时我们需要把静态资源添加到项目的静态资源中。

debug_toolbar的静态资源文件在 /usr/local/lib/python3.6/dist-packages/debug_toolbar/static 文件夹下，把这个文件夹下的debug_toolbar文件夹复制到项目的static静态资源文件夹下，问题就解决了。