Python 3.7安装后提示“不是内部或外部命令”怎么解决
针对Windows安装Python 3.7后在命令提示符运行提示“不是内部或外部命令”的问题,本文详细分析PATH环境变量缺失的原因,并提供寻找安装路径、手动配置系统环境变量以及验证生效的完整操作步骤。
python 后,若系统提示“'python' 不是内部或外部命令,也不是可运行的程序或批处理文件”,其根本原因是 Windows 的系统环境变量 Path 中缺少了 Python 3.7 的安装主目录与 Scripts 目录路径。只需将这两个安装路径添加至系统环境变量,或者通过安装安装包重新勾选自动添加选项,即可彻底解决该问题。
一、为什么会出现“不是内部或外部命令”
当我们在 Windows 的终端窗口中输入一个指令(例如 python)并按下回车时,操作系统并不会全盘扫描所有磁盘去寻找这个程序。操作系统有一套标准且高效的执行文件查找顺序:首先检查当前终端所在的目录;如果在当前目录找不到 python.exe,系统就会依序读取系统环境变量中的 Path 列表,在列表中登记的各个文件夹内逐一寻找。
Python 3.7 在安装时,安装程序默认并没有勾选“Add Python 3.7 to PATH”选项。如果安装时直接点击了快速安装(Install Now),系统环境变量中就不会写入 Python 的安装路径。当终端向系统索取 python 时,Windows 遍历了当前目录和已有的 PATH 路径均无所获,便会抛出“不是内部或外部命令,也不是可运行的程序或批处理文件”的提示。
二、定位 Python 3.7 的实际安装路径
在配置环境变量前,必须先获取 Python 3.7 在本机硬盘上的实际存放路径。根据安装方式的不同,常见的安装路径分为以下两种:
-
单用户默认安装路径(常见):
安装时若选择了默认设置,通常位于当前用户的 AppData 目录下:
C:\Users\<用户名>\AppData\Local\Programs\Python\Python37注:
AppData为隐藏文件夹,可在文件资源管理器地址栏直接输入%LocalAppData%\Programs\Python\Python37回车快速打开。 -
自定义安装路径或所有用户安装路径:
若在安装时指定了全局路径或自定义路径,通常位于根目录或指定盘符,例如:
C:\Python37或D:\Python37
可以通过打开“文件资源管理器”,浏览到上述文件夹。如果看到文件夹内存在 python.exe,以及一个名为 Scripts 的子文件夹,则证明这就是需要配置的正确安装目录。
三、手动配置环境变量 PATH 的完整步骤
确定了安装路径后,按照以下标准步骤将其写入系统的 Path 变量中:
-
打开系统属性设置:
按下键盘上的快捷键 Win + R 打开“运行”窗口,输入sysdm.cpl并按下回车,直接呼出“系统属性”面板。 -
进入环境变量配置:
在弹出的“系统属性”窗口顶部选择“高级”选项卡,然后点击右下角的“环境变量”按钮。 -
选择并编辑 Path 变量:
在环境变量窗口中,可以在“用户变量”或“系统变量”区域中找到名为Path的变量(建议在“用户变量”中修改当前用户,或在“系统变量”中修改以供所有用户使用)。双击Path或选中后点击“编辑”。 -
添加 Python 核心路径:
在“编辑环境变量”列表中点击“新建”,分别添加以下两条路径(请根据实际用户名或盘符替换):C:\Users\<用户名>\AppData\Local\Programs\Python\Python37\C:\Users\<用户名>\AppData\Local\Programs\Python\Python37\Scripts\
-
逐层确认保存并重启终端:
连续点击三次“确定”按钮保存设置并关闭所有属性窗口。必须关闭之前已打开的命令提示符窗口并重新打开,新的环境变量才能被终端载入。
四、为什么必须同时添加 Scripts 目录
许多初学者在配置环境变量时,仅将 Python37 的主目录添加到了 Path 中。这虽然能让 python 命令正常运行,但当后续尝试使用 pip install 安装第三方扩展库,或者运行 wheel、pytest 等命令行工具时,依然会收到同样的“不是内部或外部命令”错误。
这是因为 Python 的生态工具采用了分目录存放机制:
-
主目录(...\Python37):
存放python.exe(交互解释器与脚本执行器)、pythonw.exe(无控制台窗口执行器)以及标准库底层动态链接库。负责响应python命令。 -
脚本目录(...\Python37\Scripts):
存放 Python 官方包管理器pip.exe、pip3.exe、easy_install.exe,以及所有通过 pip 全局安装的第三方工具可执行脚本。负责响应pip及各类包命令。
五、配置生效验证与常见排查细节
完成环境变量写入并重启终端后,请按以下步骤逐一验证环境是否完全就绪:
1. 验证命令执行与版本输出
在新建的 CMD 或 PowerShell 窗口中分别执行以下命令:
# 检查 Python 解释器
python --version
# 正确返回示例:
# Python 3.7.9
# 检查 pip 工具
pip --version
# 正确返回示例:
# pip 20.1.1 from c:\users\...\python37\lib\site-packages\pip (python 3.7)
若两条命令均能正常打印版本号及所在安装路径,说明环境变量配置已完全生效。
2. 常见问题排查与注意事项
-
未重启命令提示符窗口:
Windows 已经打开的 CMD 窗口仅会在启动之初读取一次环境变量缓存。修改系统属性后,原先打开的黑窗口无法感知最新改动,必须关闭后重新打开。 -
Windows 10/11 应用商店别名劫持:
在较新的 Windows 系统中输入python时,可能会弹出微软应用商店(Microsoft Store)下载页面,而不是报错或进入环境。这是由于 Windows 自带的“应用执行别名”优先级高于自定义 PATH。解决方法:打开 Windows“设置” -> “应用” -> “应用执行别名”,将python.exe和python3.exe的开关关闭即可。 -
路径末尾分号或多余空格:
在 Windows 10/11 的图形化多行环境变量列表中,每一行都是独立项,无需手动在末尾添加英文分号(;)。如果手动加了分号或前后误加了空格,系统可能会将整个带符号的文本作为目录名进行查找,从而导致识别失败。 -
最省力的重新安装修复法:
如果对修改系统变量感到繁琐,也可以重新运行当初下载的 Python 3.7 安装包(例如python-3.7.9-amd64.exe),在向导界面点击 Modify(修改),勾选所有功能后进入下一步,在高级选项界面勾选 “Add Python to environment variables”,点击确认即可由官方安装器自动完成环境变量配置。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









