Django主线程异常：执行runserver命令时遭遇错误

问题拆解 #

1. 执行python manage.py runserver时触发ModuleNotFoundError: No module named 'django'——当前Python环境未安装Django框架。
2. 尝试安装Django时pip命令报错——pip版本过低或环境配置存在问题。

分步解决 #

• 升级pip到最新版本
  执行以下命令更新pip：

  python -m pip install --upgrade pip
  

  若遇到权限限制（如Windows系统），添加--user参数：

  python -m pip install --upgrade pip --user
  

• 安装Django框架
  升级完成后，安装Django：

  pip install django
  

  网络不稳定时，可使用国内镜像源加速安装：

  pip install django -i https://pypi.tuna.tsinghua.edu.cn/simple
  

• 重新启动项目
  安装完成后再次执行启动命令：

  python manage.py runserver
  

额外提示 #

• 若使用虚拟环境，确保已激活对应环境后再执行上述命令，避免全局环境与项目环境混淆。
• 可通过python -m pip --version确认pip与当前Python环境匹配，避免路径不一致导致的问题。

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