Windows下Python 3.7环境变量配置详细步骤
详细介绍在Windows操作系统中手动配置Python 3.7环境变量的完整流程,包含主程序路径与Scripts目录定位、系统环境变量编辑、多版本冲突排查及终端验证方法。
在Windows操作系统中安装Python 3.7后,如果直接在命令提示符(CMD)或PowerShell中键入 python 或 pip,经常会遇到提示“'python' 不是内部或外部命令,也不是可运行的程序或批处理文件”,或者系统意外打开了Microsoft Store应用商店。产生这一现象的核心原因,是操作系统尚未获知Python 3.7核心文件所在的物理存储路径。配置环境变量的本质,就是把Python的安装路径及命令工具目录登记到Windows全局搜索列表 Path 中。本文将按实际操作次序,详细说明定位关键路径、打开系统属性、录入变量及终端验证的完整步骤。
一、准备工作:确认Python 3.7的两个核心目录
在配置环境变量之前,必须先准确找到Python 3.7安装在磁盘上的具体路径。与许多单一运行文件的工具不同,完整的Python开发环境需要向系统Path中同时注册两个关键目录:
- 主运行环境目录:存放
python.exe(解释器核心)、pythonw.exe(GUI脚本无控制台执行器)以及核心标准库DLL文件。配置该目录后,终端才能随时响应python命令。 - 脚本工具目录(Scripts):位于主目录下的
Scripts文件夹中,存放pip.exe、pip3.exe、wheel.exe以及后续安装的所有第三方包附加的命令行工具(如pytest.exe、flake8.exe)。若遗漏该目录,虽然能运行Python代码,但无法在终端直接通过pip安装第三方库。
根据安装Python 3.7时的选项不同,这两个目录通常位于以下两处物理路径之一:
- 全局自定义路径或为所有用户安装:常见形式为
C:\Python37\与C:\Python37\Scripts\,或者C:\Program Files\Python37\。 - 当前用户默认安装路径:路径格式通常为
C:\Users\<用户名>\AppData\Local\Programs\Python\Python37\与其下的Scripts目录。由于AppData默认为系统隐藏文件夹,可在文件资源管理器地址栏直接输入%LocalAppData%\Programs\Python\Python37并按回车直达。
python.exe,并在进入 Scripts 子目录后能够看到 pip.exe。确认无误后,将这两个路径完整复制保存,供下一步操作使用。
二、核心操作:打开系统属性并编辑Path变量
明确了需要添加的两条目录路径后,接下来通过Windows系统内置的设置界面将它们添加到环境变量中。无论在Windows 10还是Windows 11中,按照以下标准步骤操作即可:
第 1 步:快捷唤出“系统属性”窗口
同时按下键盘上的 Win + R 快捷键打开“运行”对话框,在输入框中键入 sysdm.cpl,随后按回车键或点击“确定”。这是直接打开“系统属性”窗口最稳妥高效的方式,避免了不同Windows版本在“设置”或“控制面板”中层级入口各异的问题。
第 2 步:进入环境变量管理面板
在弹出的“系统属性”窗口顶部,点击切换到 “高级” 选项卡,然后点击窗口右下角的 “环境变量(N)...” 按钮,进入环境变量配置主面板。
第 3 步:选定目标Path变量区域
环境变量窗口分为上下两个独立区域:
- “<当前用户名> 的用户变量”:此处的变量仅对当前Windows登录用户生效。若当前账号没有系统管理员权限,或仅希望在当前用户下使用Python 3.7,可选择编辑此处的
Path。 - “系统变量”:此处的变量对该计算机上的所有Windows登录账户生效。如果在家庭或个人开发电脑上拥有管理员权限,推荐直接在“系统变量”区域中找到并修改
Path。
在所选区域的变量列表中滚动找到名为 Path(不区分大小写)的条目,单击选中它,随后点击下方的 “编辑(E)...” 按钮。
第 4 步:新建并添加两条路径
在现代Windows 10/11系统中,弹出的“编辑环境变量”界面为可视化的列表清单:
- 点击右上角的 “新建” 按钮,在列表底部出现的光标输入框中,粘贴之前复制的Python主目录绝对路径(例如
C:\Python37\)。 - 再次点击 “新建” 按钮,在新的输入行中粘贴Scripts子目录绝对路径(例如
C:\Python37\Scripts\)。 - 分别选中刚刚添加的这两条记录,点击右侧的 “上移” 按钮,将其逐级移动到列表靠前的位置。这一步至关重要,它能确保Windows在终端输入命令时优先找到该版本的Python,防止被后方的其它同名可执行文件覆盖。
;,接着追加两条路径并以分号隔开,例如:;C:\Python37\;C:\Python37\Scripts\。
第 5 步:逐层点击“确定”保存设置
路径录入完毕后,必须依次点击各个窗口的 “确定” 按钮:
- 首先点击“编辑环境变量”窗口右下角的 “确定”。
- 接着点击“环境变量”主窗口右下角的 “确定”。
- 最后点击“系统属性”窗口底部的 “确定”。
三、终端验证:确认配置是否正式生效
配置并保存环境变量后,需要通过实际指令检验操作系统是否能够正确识别并调用Python 3.7。
第一步关键动作:重启终端。如果当前桌面已经打开了命令提示符(CMD)或PowerShell,请务必先将它们全部关闭,随后按下 Win + R 键输入 cmd 回车,打开一个全新的终端窗口。已经启动的命令行进程无法自动感知外部环境变量的即时变化,必须启动新进程以加载最新的Path表。
在全新的命令提示符中,依次运行以下三条验证命令:
1. 检验 Python 主运行程序:
C:\Users\Admin> python --version [示例输出] Python 3.7.9
如果输出显示具体的Python 3.7版本号,说明系统已成功通过主目录找到 python.exe。
2. 检验 pip 官方包管理器:
C:\Users\Admin> pip --version [示例输出] pip 19.2.3 from C:\Python37\lib\site-packages\pip (python 3.7)
输出结果不仅展示了pip版本,还明确指出了其物理文件所在的安装路径。若路径指向对应的Python 3.7目录,说明Scripts路径配置正常。
3. 检验可执行文件解析优先级:
C:\Users\Admin> where python [示例输出] C:\Python37\python.exe C:\Users\Admin\AppData\Local\Microsoft\WindowsApps\python.exe
where 命令会按系统Path中的顺序,依次列出所有被发现的同名可执行文件。排在最前方的第一行,就是当前操作系统在响应 python 时实际执行的目标。如果第一行精确显示为Python 3.7的安装路径,说明优先级设定完全正确。
四、常见问题排查与避坑指南
若在执行验证命令时遇到异常状况,可按照下列高频问题对照排查:
1. 输入 python 却意外弹出了微软应用商店(Microsoft Store)
这是Windows 10和Windows 11中最常见的现象。Windows系统在 %LOCALAPPDATA%\Microsoft\WindowsApps 目录下预置了指向应用商店的0KB引导快捷方式。当系统Path中该目录排在自定义Python路径之前,系统就会优先触发应用商店引导页。
解决办法:
- 方法 A(调优顺序):重新打开环境变量设置,在Path列表中选中Python 3.7的两条路径,通过“上移”按钮将它们移动到
WindowsApps目录的上方。 - 方法 B(关闭别名):进入Windows“设置” ➜ “应用” ➜ “高级应用设置”(部分版本为“应用和功能”) ➜ “应用执行别名”,在列表中找到“应用安装程序 (python.exe)”与“应用安装程序 (python3.exe)”,将它们的开关全部设为“关闭”。
2. 仍然提示“'python' 不是内部或外部命令”
如果配置完成后终端依然报该错误,请逐项检查:
- 确认是否使用的是重新打开的全新CMD窗口,而不是修改前就在后台运行的旧窗口或集成开发环境(如VS Code)内置终端。
- 在终端输入
echo %PATH%并回车,仔细查看打印出的一长串系统路径中,是否确实包含刚刚录入的Python目录。 - 检查路径拼写是否包含多余的中文全角标点、空格,或将斜杠方向打错。
- 打开文件资源管理器直接访问该路径,确保该目录下确实存在
python.exe,排查是否误将安装安装包的下载目录当成了Python程序安装目录。
3. 计算机中装有多个Python版本(如Python 3.7与Python 3.10共存)
由于旧项目或某些专用库必须在3.7版本下运行,而新项目可能采用更高版本,多版本共存十分普遍。此时应当注意:
- Path列表中哪个版本的路径排在最前面,输入
python时就会默认调用哪个版本。若希望以3.7作为系统默认,务必将其通过“上移”按钮置顶。 - 可借助Windows下Python自带的启动器:在命令行直接运行
py -3.7即可明确唤起Python 3.7环境;需要为3.7安装扩展库时,可执行py -3.7 -m pip install <包名>,这样无论环境变量次序如何调整,都能精准调用特定版本。
五、配置速查表
为了便于后续核对配置或在其他设备上快速复现,可对照下表进行配置项快速核验:
| 配置项目 | 典型路径示例 | 包含核心文件 | 功能目的 | 验收命令 |
|---|---|---|---|---|
| Python主运行目录 | C:\Python37\ |
python.exepythonw.exe |
允许在终端任意工作路径下执行Python交互式解释器和运行.py脚本 | python -V |
| Scripts脚本目录 | C:\Python37\Scripts\ |
pip.exepip3.exe |
允许在终端直接调用包管理器安装依赖,并执行第三方命令行工具 | pip -V |
| 路径优先级检查 | 置于系统Path列表前列 | - | 保证命令优先被Python 3.7拦截,防止被WindowsApps或新版Python遮蔽 | where python |
| 全局环境生效 | 系统变量 / 用户变量 | - | 三层“确定”保存写入注册表后,启动全新终端即可全局生效 | echo %PATH% |
只要严格按照上述定位目录、追加两条关键路径、按顺序上移置顶并依次点击确定保存的流程操作,即可彻底解决Windows环境下Python 3.7及pip命令无法识别的问题。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









