Python新手遇KeyError: 'use_threading'，无法启动Django runserver

这个错误通常是Django版本与Python版本不兼容、Django包损坏或命令配置异常导致的，以下是针对性的解决步骤：

• 检查版本兼容性
  执行pip show django查看当前Django版本，Python3.8建议搭配Django3.2.x至4.2.x的稳定版本（过高或过低的版本可能存在参数不匹配问题）。如果版本不兼容，卸载后重新安装对应版本：

  pip uninstall django
  pip install django==3.2.20  # 示例稳定版本，可按需选择兼容版本
  

• 修复损坏的Django包
  即使版本兼容，也可能存在包文件损坏的情况，强制重新安装Django：

  pip install --force-reinstall django==你的目标版本
  

• 排查自定义命令冲突
  检查项目根目录下是否存在management/commands/runserver.py文件，若有则删除或重命名——自定义命令可能覆盖了Django默认的runserver参数配置。

• 重置虚拟环境（若使用）
  如果是虚拟环境下的问题，删除现有虚拟环境后重新创建，再重新安装所有依赖：

  # Windows系统删除旧虚拟环境（以venv为例）
  rmdir /s venv
  # 创建新虚拟环境
  python -m venv venv
  # 激活虚拟环境
  venv\Scripts\activate
  # 重新安装依赖
  pip install django==指定版本
  

  # Linux/macOS系统删除旧虚拟环境（以venv为例）
  rm -r venv
  # 创建新虚拟环境
  python -m venv venv
  # 激活虚拟环境
  source venv/bin/activate
  # 重新安装依赖
  pip install django==指定版本
  

报错详情 #

Watching for file changes with StatReloader
Exception in thread django-main-thread:
Traceback (most recent call last):
  File "C:\Users\[Name]\AppData\Local\Programs\Python\Python38\lib\threading.py", line 932, in _bootstrap_inner
    self.run()
  File "C:\Users\[Name]\AppData\Local\Programs\Python\Python38\lib\threading.py", line 870, in run
    self._target(self._args, self._kwargs)
  File "C:\Users\[Name]\AppData\Local\Programs\Python\Python38\lib\site-packages\django\utils\autoreload.py", line 64, in wrapper
    fn(*args, **kwargs)
  File "C:\Users\[Name]\AppData\Local\Programs\Python\Python38\lib\site-packages\django\core\management\commands\runserver.py", line 127, in inner_run
    threading = options["use_threading"]
KeyError: 'use_threading'

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