Django开发利器——django-debug-toolbar

早就听说了django-debug-toolbar的大名，但一直没有尝试过，是不是有点太OUT啦？！今天偶然又看到了它，版本已经更新到 0.8.1了，于是就下载了最新版本，试用了一下。配置过程本来很简单，但也经过了一番小折腾，这里记录下来，分享给后来人。

首先，请猛击这里下 载，我下载了当前的最新release版本0.8.1，我的环境是XP+Python2.5+Django1.1.1。接下来按照官方的文档进行配置。

1.解压缩下载来的安装包，执行setup.py install进行安装。官方文档说第一步先添加debug_toolbar目 录到PATHONPATH，其实是没有必要的，安装后已经自动将该目录添加进去了（文档没有更新？）。如果不塌实，可以用下列命令查看一下：

import sys
sys.path

如果没有的话，使用如下命令添加：

sys.path.append('C:\Python25\Lib\site-packages\django_debug_toolbar-0.8.1-py2.5.egg\debug_toolbar')

请注意python的安装路径与实际保持一致。

2.修改django站点的settings.py，进行配置，共有4处。

• 安装debug_toolbar的app，在INSTALLED_APPS中增加如下行：
  
  'debug_toolbar',
  
  
• 安装debug_toolbar的中间件，在MIDDLEWARE_CLASSES中增加如下行：
  
  'debug_toolbar.middleware.DebugToolbarMiddleware',
  文档提示说，如果你的站点启用了压缩中间件：GZipMiddleware，则必须将这一行放到它的后面。反正放到最后一行就对了：）
  
  
• 增加INTERNAL_IPS设置，添加如下行代码：
  
  INTERNAL_IPS = ('127.0.0.1',)
  
  
• 设置模板，添加debug_toolbar的模板目录到TEMPLATE_DIRS：
  
  'C:/Python25/Lib/site-packages/django_debug_toolbar-0.8.1-py2.5.egg/debug_toolbar/templates',
  
  

好了，到这里大功即已告成。注意，如果你是为了测试debug_tool创建了一个新的站点，务必要渲染一个模板，让站点有一个可以访问的页面，否 则是得不到debug_tool的界面的。我就是因为这个原因配置完成后看不到效果，纠结了很久：（。貌似新版本才有这样的限制，见别人配置的旧版本的截 图，在It’s work界面，debug_tool就已经显示出来了。

另外0.8.1跟老版本的UI有很大的改观，不再位于页面的顶部，而放到了页面的右侧，颜色也不再是django的墨绿了，很cool哦：

右侧显示的项目是可以定制的，在settings.py中增加如下配置项，将不需要的项目注释掉即可：

DEBUG_TOOLBAR_PANELS = (
        'debug_toolbar.panels.version.VersionDebugPanel',
        'debug_toolbar.panels.timer.TimerDebugPanel',
        'debug_toolbar.panels.settings_vars.SettingsVarsDebugPanel',
        'debug_toolbar.panels.headers.HeaderDebugPanel',
        'debug_toolbar.panels.request_vars.RequestVarsDebugPanel',
        'debug_toolbar.panels.template.TemplateDebugPanel',
        'debug_toolbar.panels.sql.SQLDebugPanel',
        'debug_toolbar.panels.signals.SignalDebugPanel',
        'debug_toolbar.panels.logger.LoggingPanel',
)

还可以有更灵活的配置，请猛击这里围 观。好了，开始debug_toolbar这件利器的体验之旅吧！