Django调试工具[编辑 | 编辑源代码]

简介[编辑 | 编辑源代码]

Django调试工具是开发过程中用于诊断问题、优化性能和分析代码行为的工具集合。它们帮助开发者快速定位错误、检查数据库查询、跟踪请求/响应周期，并验证模板渲染逻辑。对于初学者，调试工具能显著降低学习曲线；对于高级用户，它们提供了深度分析能力。

核心调试工具[编辑 | 编辑源代码]

1. Django Debug Toolbar[编辑 | 编辑源代码]

Django Debug Toolbar 是一个可视化面板，显示当前请求/响应的详细信息，包括：

SQL 查询及执行时间
请求头和响应头
模板渲染上下文
缓存状态

安装与配置[编辑 | 编辑源代码]

pip install django-debug-toolbar

在 `settings.py` 中启用：

INSTALLED_APPS += ['debug_toolbar']
MIDDLEWARE += ['debug_toolbar.middleware.DebugToolbarMiddleware']
INTERNAL_IPS = ['127.0.0.1']  # 仅本地开发环境启用

在 `urls.py` 中添加路径：

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

2. `print()` 与日志记录[编辑 | 编辑源代码]

虽然简单，但在快速调试时非常有效：

# views.py
def my_view(request):
    print(request.GET)  # 打印GET参数
    import logging
    logger = logging.getLogger(__name__)
    logger.debug("This is a debug message")
    return HttpResponse("Check your console!")

配置日志级别（`settings.py`）：

LOGGING = {
    'version': 1,
    'handlers': {
        'console': {
            'level': 'DEBUG',
            'class': 'logging.StreamHandler',
        },
    },
    'loggers': {
        'django': {
            'handlers': ['console'],
            'level': 'INFO',
        },
    },
}

3. Django的 `pdb` 调试[编辑 | 编辑源代码]

使用Python内置调试器在代码中设置断点：

# views.py
def complex_calculation():
    import pdb; pdb.set_trace()  # 断点
    result = 42 * 3.14
    return result

交互式命令示例：

`n` (next line)
`c` (continue)
`l` (list code)

高级调试场景[编辑 | 编辑源代码]

数据库查询优化[编辑 | 编辑源代码]

通过Debug Toolbar发现N+1查询问题：

# 低效查询
books = Book.objects.all()
for book in books:
    print(book.author.name)  # 每次循环触发新查询

# 优化后
books = Book.objects.select_related('author').all()