Windows 11执行pipenv install --dev提示找不到django等包，如何解决？

以下是针对Windows 11环境下的排查和解决步骤：

• 检查并更换PyPI源
  默认PyPI源在国内访问可能不稳定，直接改用国内镜像源：

  1. 在用户目录（C:\Users\<你的用户名>）下新建pip文件夹，里面创建pip.ini文件，写入内容：

     [global]
     index-url = https://pypi.tuna.tsinghua.edu.cn/simple
     

  2. 或者在执行安装命令时临时指定源：

     pipenv install --dev --pypi-mirror https://pypi.tuna.tsinghua.edu.cn/simple
     

• 验证Python版本匹配性
  确保pyenv激活的Python版本和项目Pipfile中指定的版本一致：

  1. 执行pyenv version查看当前生效的Python版本
  2. 对比项目根目录下Pipfile里的python_version字段，若不匹配，执行pyenv local <对应版本号>设置项目本地Python版本，之后重新激活pipenv shell再尝试安装。

• 清除缓存并重建虚拟环境
  缓存损坏可能导致包查找失败：

  1. 清除pip缓存：pip cache purge
  2. 删除现有pipenv虚拟环境：pipenv --rm
  3. 重新激活shell并安装：pipenv shell，之后执行pipenv install --dev

• 检查Pipfile中的包版本约束
  查看Pipfile里的包版本是否合理，比如某些旧版本的Django不支持当前Python版本，或者版本号书写错误（比如多打了空格、符号错误），调整为兼容当前Python版本的包版本后再尝试安装。

• 确认网络连通性
  测试能否正常访问国内PyPI镜像源（比如在浏览器打开镜像地址），确保网络没有被代理、防火墙拦截。

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