两个 Django 插件( django_extensions,django_toolbar)

1. 前言

使用 Django 进行 Web 开发的时候,为了提高开发效率,少不了安装一些第三方应用 App

本篇文章将推荐 2 款非常好用的应用 App

  • django_extensions

  • debug_toolbar

2. django_extensions

django_extensions,是一个为 Django 项目收集全局自定义管理扩展的存储库

首先,在目标虚拟环境下安装依赖

# 安装依赖
pip3 install django-extensions

然后,在项目的配置文件 settings.py 中添加 App

# settings.py

# 调试模式
DEBUG = True

# 新增App:django_extensions
INSTALLED_APPS =(
    ...
    'django_extensions',
    ...

接下来就可以使用它进行项目调试了

常见的功能如下:

2-1  增强版 Shell

我们都知道,原始项目都是使用「 ./manage.py  shell 」命令进入到调试模式,涉及到模型 Model 操作都需要手动导入

然而,添加 django_extensions 应用后,直接使用「 ./manage.py  shell_plus 」命令就可以进入到增强版的 Shell,自动导入项目下所有模型,非常方便我们调试

 

2-2  检查模板错误

使用「 ./manage.py validate_templates 」命令可以检测模板中的错误

# 检查模板错误
(django) localhost:xh_tools xingag$ ./manage.py validate_templates
0 errors found

2-3 查看路由列表

使用「 ./manage.py show_urls 」命令可以查看项目所有的路由及视图函数对应关系表

更多功能可以参考:

https://github.com/django-extensions/django-extensions

3. django_toolbar

django_toolbar,是一款 Django 开发利器,在 Debug 模式下,能实时展示项目的整体信息、请求响应、SQL、缓存等内容

首先,在虚拟环境下安装依赖包

# 安装依赖包
pip3 install django-debug-toolbar

然后,在项目配置文件 settings.py 中,对 django_toolbar 进行配置

3-1  添加应用

# settings.py

# 调试模式
DEBUG = True

# 新增App:django_extensions
INSTALLED_APPS =(
    ...
    'debug_toolbar',
    ...

3-2  启用 django_toolbar 中间件

在 MIDDLEWARE 列表中,尽早的启动 django_toolbar 中间件

注意:中间件的位置很重要,djano_toolbar 中间件必须位于对响应内容进行编码的任何其他中间件之后

# settings.py

MIDDLEWARE = [
    'debug_toolbar.middleware.DebugToolbarMiddleware',
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.locale.LocaleMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

参考:

https://docs.djangoproject.com/en/dev/ref/middleware/#django.middleware.gzip.GZipMiddleware

3-3  配置内部 IP

必须要在配置文件 settings.py 设置 INTERNAL_IPS 的值为本地 IP,才会在网页上展示调试工具栏

# settings.py

INTERNAL_IPS = [
    '127.0.0.1',
    'localhost'
]

3-4  配置显示内容( 可选 )

默认工具栏展示所有内容,也可以定义 DEBUG_TOOLBAR_PANELS 列表的值,指定显示部分内容

比如:仅配置加载时间、请求头和响应头、请求信息、SQL 语句、缓存、日志信息

# settings.py

DEBUG_TOOLBAR_PANELS = [
    'debug_toolbar.panels.timer.TimerPanel',
    'debug_toolbar.panels.headers.HeadersPanel',
    'debug_toolbar.panels.request.RequestPanel',
    'debug_toolbar.panels.sql.SQLPanel',
    'debug_toolbar.panels.cache.CachePanel',
    'debug_toolbar.panels.logging.LoggingPanel',
]

最后,在项目下的 urls.py 文件内配置调试工具栏的 URL

# 项目下的urls.py

# 配置调试工具栏的URL
urlpatterns = [
    path('', include('index.urls')),
    path('admin/', admin.site.urls),

    # 设置项目上线的静态资源路径
    url('^static/(?P<path>.*)$', static.serve,
        {'document_root': settings.STATIC_ROOT}, name='static')
]

# 如果是调式状态
if settings.DEBUG:
    import debug_toolbar

    urlpatterns = [
                      path('__debug__/', include(debug_toolbar.urls)),
                  ] + urlpatterns

以调试模式运行项目后,就可以在网页上看到工具栏的实时信息了

 

更多功能可以参考:

https://github.com/jazzband/django-debug-toolbar

4. 最后

文中推荐了两款非常实用的 Django 开发辅助应用,它可以帮助我们对项目进行调试,快速定位问题。

posted @ 2021-07-22 14:20  侃豺小哥  阅读(757)  评论(0编辑  收藏  举报