ModuleNotFoundError：没有名为“debug_toolbar”的模块

作者

ModuleNotFoundError: 没有名为“debug_toolbar”的模块

ModuleNotFoundError: No module named ‘debug_toolbar’

Python “ModuleNotFoundError: No module named ‘debug_toolbar’” 发生在我们忘记django-debug-toolbar在导入前安装模块或将其安装在错误的环境中时。

要解决此错误，请通过运行命令安装模块
pip install django-debug-toolbar。

modulenotfounderror 没有名为调试工具栏的模块

在项目的根目录中打开终端并安装
django-debug-toolbar模块。

壳
# 👇️ in a virtual environment or using Python 2
pip install django-debug-toolbar

# 👇️ for python 3 (could also be pip3.10 depending on your version)
pip3 install django-debug-toolbar

# 👇️ if you get permissions error
sudo pip3 install django-debug-toolbar
pip install django-debug-toolbar --user

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install django-debug-toolbar

# 👇️ for python 3 (could also be pip3.10 depending on your version)
python3 -m pip install django-debug-toolbar

# 👇️ using py alias (Windows)
py -m pip install django-debug-toolbar

# 👇️ for Anaconda
conda install -c conda-forge django-debug-toolbar

# 👇️ for Jupyter Notebook
!pip install django-debug-toolbar

安装
django-debug-toolbar包后，确保它django.contrib.staticfiles在您的INSTALLED_APPS设置中。

设置.py
INSTALLED_APPS = [
    # ...
    "django.contrib.staticfiles",
    # ...
    "debug_toolbar",
]

STATIC_URL = "static/"
请注意条目后的尾随逗号。缺少逗号会导致. ModuleNotFoundError

确保您的TEMPLATES设置包含DjangoTemplates设置APP_DIRS为True.

设置.py
TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "APP_DIRS": True,
        # ...
    }
]

将 django-debug-toolsbar 的 URL 添加到项目的 URLconf。

主程序
from django.urls import include, path

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

最后，将调试工具栏添加到您的MIDDLEWARE设置中。

设置.py
MIDDLEWARE = [
    # ...
    "debug_toolbar.middleware.DebugToolbarMiddleware",
    # ...
]
尽早在MIDDLEWARE 列表中包括调试工具栏，但在对响应内容进行编码的中间件之后（例如）。 GZipMiddleware

如果您收到错误
ModuleNotFoundError: No module named ‘django’，请单击链接并按照说明进行操作。

常见错误原因

出现错误的原因有多种：

  1. 没有django-debug-toolbar通过运行安装包
    pip install django-debug-toolbar。
  2. 在与您正在使用的版本不同的 Python 版本中安装包。
  3. 全局安装包，而不是在您的虚拟环境中。
  4. 您的 IDE 运行的 Python 版本不正确。
  5. 命名您的模块debug_toolbar.py，这将影响官方模块。
  6. 声明一个名为debug_toolbarwhich 的变量将隐藏导入的变量。

如果错误仍然存​​在，请获取您的 Python 版本并确保您使用正确的 Python 版本安装包。

壳
python --version

获取 python 版本

例如，我的 Python 版本是3.10.4，所以我将
django-debug-toolbar使用pip3.10 install django-debug-toolbar.

壳
pip3.10 install django-debug-toolbar

# 👇️ if you get permissions error use pip3 (NOT pip3.X)
sudo pip3 install django-debug-toolbar

请注意，版本号对应于我正在使用的版本pip。

pip如果您的计算机上未设置PATH ，请替换pip为
python3 -m pip：

壳
# 👇️ make sure to use your version of Python, e.g. 3.10
python3 -m pip install django-debug-toolbar

如果“No module named ‘debug_toolbar’”错误仍然存​​在，请尝试重新启动您的 IDE 和开发服务器/脚本。

检查包是否安装

您可以

通过运行命令检查是否django-debug-toolbar安装了软件包pip show django-debug-toolbar。

壳
# 👇️ check if you have django-debug-toolbar installed
pip show django-debug-toolbar

# 👇️ if you don't have pip set up in PATH
python -m pip show django-debug-toolbar

该pip show django-debug-toolbar命令将声明该包未安装或显示有关该包的一堆信息，包括该包的安装位置。

确保你的 IDE 使用正确的 Python 版本

如果未安装该包，请确保您的 IDE
使用的是正确版本的 Python。

如果您的机器上安装了多个 Python 版本，您可能使用了不正确的版本安装了django-debug-toolbar包，或者您的 IDE 可能设置为使用不同的版本。

例如，在 VSCode 中，您可以按CTRL + Shift + P或（在 Mac 上为⌘+ Shift+ P
）打开命令面板。

然后在字段中键入“Python 选择解释器”。

python选择解释器

然后从下拉菜单中选择正确的 python 版本。

选择正确的python版本

您的 IDE 应该使用与您用于从终端安装包的相同版本的 Python（包括虚拟环境）。

如果您收到错误
ModuleNotFoundError: No module named ‘django’，请单击链接并按照说明进行操作。

在虚拟环境中安装包

如果您使用的是虚拟环境，请确保您是
django-debug-toolbar在虚拟环境中而不是全局安装。

如果您还没有虚拟环境，可以尝试创建一个。

壳
# 👇️ use correct version of Python when creating VENV
python3 -m venv venv

# 👇️ activate on Unix or MacOS
source venv/bin/activate

# 👇️ activate on Windows (cmd.exe)
venv\Scripts\activate.bat

# 👇️ activate on Windows (PowerShell)
venv\Scripts\Activate.ps1

# 👇️ install django-debug-toolbar in virtual environment
pip install django-debug-toolbar

如果该python3 -m venv venv命令不起作用，请尝试以下 2 个命令：

  • python -m venv venv
  • py -m venv venv

您的虚拟环境将使用用于创建它的 Python 版本。

如果错误仍然存​​在，请确保您没有在项目中命名模块，因为那样会影响原始模块。 debug_toolbar.py debug_toolbar

您也不应该声明一个名为debug_toolbaras 的变量，这也会影响原始模块。

尝试重新安装包

如果错误未解决，请尝试卸载django-debug-toolbar
软件包，然后再安装。

壳
# 👇️ check if you have django-debug-toolbar installed
pip show django-debug-toolbar

# 👇️ if you don't have pip set up in PATH
python -m pip show django-debug-toolbar

# 👇️ uninstall django-debug-toolbar
pip uninstall django-debug-toolbar

# 👇️ if you don't have pip set up in PATH
python -m pip uninstall django-debug-toolbar

# 👇️ install django-debug-toolbar
pip install django-debug-toolbar

# 👇️ if you don't have pip set up in PATH
python -m pip install django-debug-toolbar

尝试重新启动您的 IDE 和开发服务器/脚本。

您也可以尝试升级软件包的版本django-debug-toolbar。

壳
pip install django-debug-toolbar --upgrade

# 👇️ if you don't have pip set up in PATH
python -m pip install django-debug-toolbar --upgrade
如果错误仍然存​​在，我建议观看有关如何在 Python 中使用虚拟环境的快速视频。

这个用于在以下位置使用虚拟环境 (VENV) Windows：

这个用于在MacOS和上使用虚拟环境 (VENV) Linux：