Repolode
提交项目
django-commons

django-commons/django-debug-toolbar

为 Django 提供可配置面板，在浏览器中展示每次请求与响应的调试信息。

在 GitHub 查看官网
Star
8,379
Fork
1,122
未关闭 Issue
71
最近提交
4天前

这是什么？

Django Debug Toolbar 是一款面向 Django 项目的开发调试工具。它会在渲染后的页面上叠加一个工具栏，每个面板展示当前请求与响应的一类调试信息，例如 SQL 查询、请求头、模板和耗时。点击面板即可查看更详细的内容。

工具栏由一组可配置的面板组成，社区也贡献了大量第三方面板。当前版本要求 Django 5.2 及以上。它对 Django 的异步视图提供实验性支持，但尚不能处理并发请求。

安装与配置说明见项目的在线文档，项目采用 BSD-3-Clause 许可证发布。

核心功能

  • 01展示单次请求期间执行的 SQL 查询。
  • 02显示请求与响应头、模板及耗时信息。
  • 03支持内置面板，并可接入社区贡献的第三方面板。
  • 04对 Django 异步视图提供实验性支持。

适用场景

  • 在开发 Django 视图时排查 N+1 查询问题。
  • 在本地开发时检查模板渲染与上下文。
  • 调试 API 接口时查看请求与响应头。

快速上手

  1. 1

    按照文档中的安装和配置说明操作

使用前须知

  • 对 Django 异步视图的支持仍处于实验阶段，工具栏目前无法处理并发请求。
  • 需要 Django 5.2.0 或更高版本。

收录于专题

数据库与 SQL 工具

标签

#django#debugging#python#web-development#profiling#sql

常见问题

django-debug-toolbar 是什么？
为 Django 提供可配置面板，在浏览器中展示每次请求与响应的调试信息。 Django Debug Toolbar 是一款面向 Django 项目的开发调试工具。它会在渲染后的页面上叠加一个工具栏，每个面板展示当前请求与响应的一类调试信息，例如 SQL 查询、请求头、模板和耗时。点击面板即可查看更详细的内容。
django-debug-toolbar 可以免费使用吗？用的什么许可证？
django-debug-toolbar 以 BSD-3-Clause 许可证开源。用于商业产品前，请先确认许可证条款。
django-debug-toolbar 还在维护吗？
活跃维护中。django-debug-toolbar 最近一次提交是在 2026年11月3日。
django-debug-toolbar 适合用来做什么？
在开发 Django 视图时排查 N+1 查询问题。 在本地开发时检查模板渲染与上下文。 调试 API 接口时查看请求与响应头。
django-debug-toolbar 怎么安装和运行？
按照文档中的安装和配置说明操作
在哪里获取 django-debug-toolbar？
源代码和安装说明在 GitHub 上：https://github.com/django-commons/django-debug-toolbar

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目