根本原因是python安装路径未添加到path环境变量;需在用户或系统path中精确添加python主目录(含python.exe)和scripts目录,重启cmd后用where python和python --version验证。

python 命令在 Windows 下报“不是内部或外部命令”,根本原因是系统找不到 python.exe —— 它压根没被加进 PATH 环境变量,或者加了但路径不对、没生效。
安装时漏勾了 “Add Python to PATH”
这是最常见原因。Python 官方安装包(.exe)默认不自动写入环境变量,必须手动勾选那个选项。一旦跳过,哪怕安装成功,python 在任意 cmd 或 PowerShell 里都不可用。
- 重装是最省事的解法:卸载后重新运行安装程序,**务必勾选 “Add Python to PATH”**(通常在安装类型页或自定义页底部)
- 别信“默认已勾选”——2026 年最新版安装器依然默认不勾,界面文字还容易被忽略
- 勾选后安装完成,新开一个 cmd 就能直接用
python --version验证
环境变量 PATH 没配对或没生效
手动添加 PATH 是可行的,但极易出错。不是加了就完事,得确保路径存在、拼写正确、且终端重启了。
- 要加两条路径:
C:Python39(主目录,含python.exe)和C:Python39Scripts(含pip.exe等工具) - 路径里不能有错字,比如
c:pyhton39(少个h)或c:python39\(多一个反斜杠)都会失效 - 改完环境变量后,**必须关掉所有旧的 cmd/PowerShell 窗口,新开一个再试**;进程不会自动刷新
PATH - 检查是否加到了「系统变量」而非「用户变量」——后者在管理员权限下可能不继承
Microsoft Store 版 Python 不向系统注册 PATH
如果你是从 Microsoft Store 装的 Python(比如搜索“Python 3.12”点安装),它走的是 UWP / AppX 沙箱机制,python.exe 被放在 %LOCALAPPDATA%Packages... 这种私有路径下,**完全不写入系统 PATH**,也无权写。
- 这种版本无法通过
python命令调用,哪怕你手动把它的路径加进PATH,也可能因权限或路径格式问题失败 - 推荐卸载 Store 版,改从 python.org 下载官方 MSI 安装包
- 实在要用 Store 版,只能靠
py启动器:执行py -3.12 --version,但pip仍可能找不到
where python 显示多个结果但没一个是有效的
运行 where python 返回几行路径,不代表都能用。常见陷阱是其中某条指向一个空文件夹、损坏的安装,或已被卸载但残留的注册表项。
- 逐个检查输出的每个路径是否存在
python.exe:比如dir C:Python39python.exe - 如果某条路径返回“文件不存在”,就说明它只是个幽灵路径,应从
PATH中删掉 - 如果
where python什么也不输出,说明系统真的一点都不知道python.exe在哪,得先定位安装目录再补PATH
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











