Django 开发调试工具 django-debug-toolbar 使用详解

周予安
周予安
发布时间:2026-10-13 | 2人浏览过
原创

本文详细介绍 Django 开发调试工具 django-debug-toolbar 的安装与配置方法。涵盖从 pip 安装、settings.py 中注册应用、urls.py 添加路由、配置中间件及 INTERNAL_IPS,到解决国内 jQuery 加载问题的完整步骤,帮助开发者快速启用该工具以查看请求响应详情。

django-debug-toolbar 简介

django-debug-toolbar

介绍

django-debug-toolbar 提供了一组可配置的面板,用于展示当前请求和响应的各类调试信息。用户点击面板即可查看更多详细内容。

github地址

文档地址

安装与配置步骤

安装


pip3 install django-debug-toolbar

配置

1. settings.py中

将 debug_toolbar 添加到 INSTALL_APPS 中


INSTALLED_APPS = [
  …
  'debug_toolbar',
]

2. urls.py中


from django.conf import settings
from django.conf.urls import include, url

if settings.DEBUG:
  import debug_toolbar
  urlpatterns = [
    url(r'^__debug__/', include(debug_toolbar.urls)),
  ] + urlpatterns

3. settings.py中

在中间件中加入DebugToolbarMiddleware


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

4. 如果是本机调试,还在将127.0.0.1加入 INTERNAL_IPS

在settings.py中加入以下配置项:


INTERNAL_IPS = [‘127.0.0.1', ]

5. 配置jQuery的URL

django-debug-toolbar 默认使用的是Google的地址,默认配置如下:


JQUERY_URL = '//ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js'

国内用不了的话可以在settings.py中配置一下,例如(我这里特意选用了和原作者相同版本的jQuery):


DEBUG_TOOLBAR_CONFIG = {
  "JQUERY_URL": '//cdn.bootcss.com/jquery/2.2.4/jquery.min.js',
}

或者你如果在Django项目中使用了jquery的话就可以直接将这一项置为空,那么django-debug-toolbar 就会使用你项目中用到的jquery:


DEBUG_TOOLBAR_CONFIG = {
  "JQUERY_URL": '',
}

工具使用方法

使用

访问具体路径的时候在页面右侧有各项配置面板,点击即可查看各种调试信息。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表