核心原因是配置未生效或配错：路径未加入PATH、终端未刷新、存在多版本冲突。应先用echo %PATH%确认路径存在，关闭所有终端重开新窗口，再运行python --version和pip --version验证，并用where python排查版本优先级。
环境变量配置好后仍报错，核心原因不是“没配”，而是“配了但没生效”或“配得不对”。最常见的情况是：路径加错了、终端没刷新、系统没读到，或者多个版本互相打架。
检查PATH里有没有你加的路径
打开命令提示符（cmd），输入：
echo %PATH%
看输出里是否包含你添加的Python主目录（如 C:\Users\XXX\AppData\Local\Programs\Python\Python312）和Scripts目录（如 ...\Python312\Scripts）。注意：
- 路径之间必须用英文分号;隔开
- 不能有中文、空格、引号或多余回车
- 如果没出现，说明根本没写进PATH，要重进「环境变量」设置重新添加
关掉再开新命令行窗口
Windows不会自动把新PATH同步给已打开的终端。哪怕刚点完“确定”，当前cmd窗口依然用的是旧环境。
必须：
- 完全关闭所有cmd/PowerShell窗口
- 重新按Win+R → 输入cmd → 回车，打开全新窗口再测试
- 不要用“新建标签页”或“继续运行”，那还是旧进程
验证python和pip是否真能调用
在新开的命令行中，分别运行：
- python --version —— 看是否显示版本号
- pip --version —— 看是否显示pip路径和版本
如果其中一个失败，比如pip报错但python正常，大概率是只加了Python主目录，漏了Scripts目录；如果两个都失败，基本是路径错误或根本没生效。
排查多版本冲突
运行这个命令：
where python
如果返回多行路径，说明电脑装了不止一个Python。系统默认调用的是列表最上面那个——可能不是你刚配的那个。
解决方法：
- 在「环境变量」→ Path中，把你希望优先使用的Python路径移到最前面
- 或者直接用完整路径测试：C:\Your\Python\Path\python.exe --version
- 日常建议统一用py -3或py -3.12来明确指定版本
