Django新手求助：虚拟环境中pipenv安装django-debug-toolkit失败

排查步骤及解决方案 #

1. 确认Django与django-debug-toolkit的版本兼容性 #

django-debug-toolkit对Django版本有明确要求，先查看当前环境的Django版本：

python -m django --version

根据版本对应关系指定安装：

• Django 4.2+/5.x：直接安装最新版

  pipenv install django-debug-toolkit
  

• Django 3.2：安装3.x系列兼容版（例如3.10.0）

  pipenv install django-debug-toolkit==3.10.0
  

• Django 2.2：安装2.x系列兼容版（例如2.2.0）

  pipenv install django-debug-toolkit==2.2.0
  

2. 检查并更换PyPI源 #

部分PyPI源可能同步不及时导致找不到包，修改Pipfile中的源为国内靠谱源（如清华源）：
打开项目根目录的Pipfile，将[[source]]部分替换为：

[[source]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
verify_ssl = true
name = "pypi"

之后重新执行安装命令。

3. 升级pip并直接用pip尝试安装 #

先激活虚拟环境，升级pip后用pip安装，再同步到pipenv：

pipenv shell
pip install --upgrade pip
pip install django-debug-toolkit
exit
pipenv lock

4. 强制创建新虚拟环境尝试 #

如果现有虚拟环境存在异常，可强制让pipenv创建新环境重新安装：

export PIPENV_IGNORE_VIRTUALENVS=1
pipenv install django-debug-toolkit

内容的提问来源于stack exchange，提问作者Rohail