升级Windows11后运行python manage.py runserver无法导入Django的解决方法

错误信息 #

运行命令 python manage.py runserver 时触发如下报错：

Traceback (most recent call last):
  File "F:\blear\manage.py", line 10, in main
    from django.core.management import execute_from_command_line
ModuleNotFoundError: No module named 'django'

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "F:\blear\manage.py", line 21, in <module>
    main()
  File "F:\blear\manage.py", line 12, in main
    raise ImportError(
ImportError: Couldn't import Django. Are you sure it's installed and available on your PYTHONPATH environment variable? Did you forget to activate a virtual environment?

解决步骤 #

1. 重新激活虚拟环境 #

Windows11升级可能破坏了虚拟环境的路径关联：

• 打开命令行，切换到项目根目录 F:\blear
• 执行对应虚拟环境的激活命令：
  • venv环境：venv\Scripts\activate
  • conda环境：conda activate 你的虚拟环境名称
• 激活成功后再次运行 python manage.py runserver

2. 检查并重装Django #

确认当前Python解释器是否安装了Django：

• 执行 pip list，查看输出中是否存在Django条目
• 若未找到，执行 pip install django（需指定版本则用 pip install django==x.x.x，替换为项目依赖的版本号）

3. 修复Python环境变量 #

Win11升级可能重置系统环境变量，导致调用了错误的Python版本：

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在「系统变量」的Path列表中，将项目使用的Python解释器路径（如虚拟环境的Scripts目录、本地Python安装目录）移至最顶端
• 重启命令行，执行 python --version 确认版本匹配，再重新运行项目

4. 重建虚拟环境（终极方案） #

若以上步骤无效，大概率是虚拟环境已损坏：

• 删除项目根目录下的旧虚拟环境文件夹（如venv）
• 执行 python -m venv venv 创建新虚拟环境
• 激活新环境后，通过 pip install -r requirements.txt 重装所有依赖（若有依赖文件），或手动安装Django及其他所需包

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