已安装Python与Django执行django-admin startproject命令报无法识别错误咨询

这个报错的核心诱因是：系统没有找到django-admin.exe可执行文件的存储路径，即便本地已经完成Python、Django的正常安装，只要对应路径没纳入系统PATH环境变量的检索范围，就会弹出提示'django-admin' 不是内部或外部命令，也不是可运行的程序或批处理文件。

分步操作流程 #

• 先确认Django安装状态：打开终端执行python -m django --version，如果能正常返回安装的Django版本号，就说明Django本身安装无损坏，问题仅出在命令路径检索环节
• 定位django-admin.exe的实际存放路径：
  • 执行where python找到当前调用的Python解释器的安装根目录，比如常见路径为C:\Users\当前用户名\AppData\Local\Programs\Python\Python3xx\
  • 进入Python根目录下的Scripts文件夹，django-admin.exe默认就存放在这个目录下，复制该文件夹的完整路径备用
• 配置系统环境变量：
  • 右键「此电脑」→ 选择「属性」→「高级系统设置」→「环境变量」
  • 在用户变量或系统变量列表中找到名为Path的条目，点击编辑
  • 选择「新建」，把刚才复制的Scripts文件夹完整路径粘贴进去，逐一点击确定保存所有配置
• 验证配置生效：
  • 彻底关闭所有已经打开的旧终端窗口，旧窗口不会自动加载新的环境变量配置
  • 重新打开新的CMD/PowerShell窗口，执行django-admin --version，能正常返回版本号就代表配置成功，后续就可以正常执行django-admin startproject MySQLCRUD创建项目

避坑提醒 #

1. 有无需改环境变量都能直接用的替代写法：如果暂时不想配置全局环境变量，可以把原来的django-admin命令替换为Python模块调用形式，即python -m django startproject MySQLCRUD，完全可以绕开命令检索问题完成项目创建
2. 虚拟环境场景下的特殊处理：如果使用项目专属虚拟环境，不需要单独给虚拟环境配置全局PATH，只要激活虚拟环境后，就可以直接调用虚拟环境自带的django-admin命令
3. 多Python版本场景注意：如果本地装了多个版本的Python，一定要把当前安装了Django的Python对应的Scripts路径加进PATH，不要错配成其他Python版本的Scripts目录，否则还是会报命令不存在的错误

内容的提问来源于stack exchange，提问作者Mohit Kumar Sharma