使用 Django 调试工具栏

首先,你需要安装 django-debug-toolbar

pip install django-debug-toolbar

settings.py

接下来,将它包含在项目安装的应用程序中,但要小心 - 将这些仅限开发的应用程序和中间件作为调试工具栏使用不同的 settings.py 文件始终是一个好习惯:

# If environment is dev...
DEBUG = True

INSTALLED_APPS += [
    'debug_toolbar',
]

MIDDLEWARE += ['debug_toolbar.middleware.DebugToolbarMiddleware']

调试工具栏也依赖于静态文件,因此也应该包含适当的应用程序:

INSTALLED_APPS = [
    # ...
    'django.contrib.staticfiles',
    # ...
]

STATIC_URL = '/static/'

# If environment is dev...
DEBUG = True

INSTALLED_APPS += [
    'debug_toolbar',
]

在某些情况下,还需要在 settings.py 中设置 INTERNAL_IPS

INTERNAL_IPS = ('127.0.0.1', )

urls.py

urls.py 中,正如官方文档所示,下一个代码片段应启用调试工具栏路由:

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

安装后收集工具栏的静态:

python manage.py collectstatic

就是这样,调试工具栏将出现在项目的页面上,提供有关执行时间,SQL,静态文件,信号等的各种有用信息。

HTML:

此外,django-debug-toolbar 需要内容类型text/html<html><body> 标签才能正确呈现。

如果你确定你已经配置好一切,但仍然没有渲染调试工具栏: 使用这个解决方案试图找出它。