Windows下Python 3.7环境变量配置详细步骤

阿澈
阿澈
发布时间:2026-11-04 | 8人浏览过
原创

详细介绍在Windows操作系统中手动配置Python 3.7环境变量的完整流程,包含主程序路径与Scripts目录定位、系统环境变量编辑、多版本冲突排查及终端验证方法。

在Windows操作系统中安装Python 3.7后,如果直接在命令提示符(CMD)或PowerShell中键入 python 或 pip,经常会遇到提示“'python' 不是内部或外部命令,也不是可运行的程序或批处理文件”,或者系统意外打开了Microsoft Store应用商店。产生这一现象的核心原因,是操作系统尚未获知Python 3.7核心文件所在的物理存储路径。配置环境变量的本质,就是把Python的安装路径及命令工具目录登记到Windows全局搜索列表 Path 中。本文将按实际操作次序,详细说明定位关键路径、打开系统属性、录入变量及终端验证的完整步骤。

Windows下Python 3.7环境变量配置详细步骤
图 1:Windows下Python 3.7全局环境变量配置目标与映射总览

一、准备工作:确认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时的选项不同,这两个目录通常位于以下两处物理路径之一:

  1. 全局自定义路径或为所有用户安装:常见形式为 C:\Python37\ 与 C:\Python37\Scripts\,或者 C:\Program Files\Python37\。
  2. 当前用户默认安装路径:路径格式通常为 C:\Users\<用户名>\AppData\Local\Programs\Python\Python37\ 与其下的 Scripts 目录。由于 AppData 默认为系统隐藏文件夹,可在文件资源管理器地址栏直接输入 %LocalAppData%\Programs\Python\Python37 并按回车直达。
核对建议:在资源管理器中进入上述文件夹后,请确认能够看到 python.exe,并在进入 Scripts 子目录后能够看到 pip.exe。确认无误后,将这两个路径完整复制保存,供下一步操作使用。
Windows下Python 3.7环境变量配置详细步骤
图 2:Python 3.7安装目录结构与Windows PATH链式寻址原理

二、核心操作:打开系统属性并编辑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系统中,弹出的“编辑环境变量”界面为可视化的列表清单:

  1. 点击右上角的 “新建” 按钮,在列表底部出现的光标输入框中,粘贴之前复制的Python主目录绝对路径(例如 C:\Python37\)。
  2. 再次点击 “新建” 按钮,在新的输入行中粘贴Scripts子目录绝对路径(例如 C:\Python37\Scripts\)。
  3. 分别选中刚刚添加的这两条记录,点击右侧的 “上移” 按钮,将其逐级移动到列表靠前的位置。这一步至关重要,它能确保Windows在终端输入命令时优先找到该版本的Python,防止被后方的其它同名可执行文件覆盖。
兼容性提醒(Windows 7等老版本系统):旧版Windows弹出的不是列表视图,而是一个带有长文本的“编辑系统变量”对话框。此时切勿覆盖原有“变量值”内容,只需在原有长字符串的最末尾先输入一个半角英文字符分号 ;,接着追加两条路径并以分号隔开,例如:;C:\Python37\;C:\Python37\Scripts\。

第 5 步:逐层点击“确定”保存设置

路径录入完毕后,必须依次点击各个窗口的 “确定” 按钮:

  1. 首先点击“编辑环境变量”窗口右下角的 “确定”。
  2. 接着点击“环境变量”主窗口右下角的 “确定”。
  3. 最后点击“系统属性”窗口底部的 “确定”。
重点注意:只有完整点击了上述三层窗口的“确定”按钮,更改才会正式被写入Windows注册表。如果中途直接点击窗口右上角的关闭按钮(“×”)或点击“取消”,刚才编辑的所有路径将全部丢失。
Windows下Python 3.7环境变量配置详细步骤
图 3:Windows环境变量配置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的安装路径,说明优先级设定完全正确。

Windows下Python 3.7环境变量配置详细步骤
图 4:Windows系统Path优先级检索逻辑与多版本/应用商店避坑原理

四、常见问题排查与避坑指南

若在执行验证命令时遇到异常状况,可按照下列高频问题对照排查:

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 <包名>,这样无论环境变量次序如何调整,都能精准调用特定版本。
Windows下Python 3.7环境变量配置详细步骤
图 5:Python 3.7环境变量配置核心检查矩阵与常见失误总结

五、配置速查表

为了便于后续核对配置或在其他设备上快速复现,可对照下表进行配置项快速核验:

配置项目 典型路径示例 包含核心文件 功能目的 验收命令
Python主运行目录 C:\Python37\ python.exe
pythonw.exe
允许在终端任意工作路径下执行Python交互式解释器和运行.py脚本 python -V
Scripts脚本目录 C:\Python37\Scripts\ pip.exe
pip3.exe
允许在终端直接调用包管理器安装依赖,并执行第三方命令行工具 pip -V
路径优先级检查 置于系统Path列表前列 - 保证命令优先被Python 3.7拦截,防止被WindowsApps或新版Python遮蔽 where python
全局环境生效 系统变量 / 用户变量 - 三层“确定”保存写入注册表后,启动全新终端即可全局生效 echo %PATH%

只要严格按照上述定位目录、追加两条关键路径、按顺序上移置顶并依次点击确定保存的流程操作,即可彻底解决Windows环境下Python 3.7及pip命令无法识别的问题。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表