Windows系统下Python、Django部署及环境变量配置问题求助

一、Python安装与环境变量配置 #

• 下载对应Windows版本的Python安装包（建议选择3.8及以上稳定版本）
• 安装操作：
  • 运行安装包时，务必勾选「Add Python to PATH」，再选择「Customize installation」进入自定义安装
  • 可选功能保持默认全选，点击「Next」
  • 高级选项中可自定义安装路径（例如D:\Python311），勾选「Add Python to environment variables」，完成安装
• 验证安装：打开命令提示符（cmd），输入python --version或py --version，能正常显示版本号即为成功

二、Django部署流程 #

• 安装Django：在cmd中执行pip install django（多Python版本环境下建议用pip3 install django）
• 验证Django：执行django-admin --version，显示版本号则安装成功
• 创建项目：进入目标项目目录（例如cd D:\Projects），执行django-admin startproject mysite
• 启动开发服务器：进入项目目录cd mysite，执行python manage.py runserver，访问127.0.0.1:8000能看到Django默认页面即为部署成功

三、「Python was not found」错误修复方案 #

问题核心：系统优先识别了Microsoft Store的Python快捷方式，而非你安装的Python版本 #

以下是分步修复步骤：

• 1. 调整环境变量优先级
  • 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  • 在系统变量的Path列表中，找到你的Python安装目录（如D:\Python311）和Scripts目录（如D:\Python311\Scripts），将它们移至列表最顶部
  • 保存设置后，关闭所有cmd窗口并重新打开，再次测试Django命令
• 2. 禁用Microsoft Store的Python别名
  • 打开Windows设置→「应用」→「应用和功能」→「可选功能」，卸载App Installer下的Python相关条目；或直接搜索「Manage app execution aliases」，关闭所有Python相关的别名开关
• 3. 使用官方py启动器
  • Windows Python官方提供的py命令可自动识别已安装版本，替换原有命令：
    • 创建项目：py -m django-admin startproject mysite
    • 启动服务器：py manage.py runserver
• 4. 检查Django安装路径的环境变量
  • 执行pip show django查看Location字段，确认该路径已添加至系统变量Path，未添加则手动补充
• 5. 验证Python命令指向
  • 执行where python，若第一个结果是C:\Users\XXX\AppData\Local\Microsoft\WindowsApps\python.exe，说明环境变量优先级错误，回到步骤1调整

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