Windows系统安装Python 3.7及环境变量配置教程
在 Windows 环境下部署 Python 3.7 开发环境,核心在于两项关键操作:一是选用适配系统架构的官方安装包完成解释器与包管理工具的安装,二是确保可执行路径被正确写入系统的 PATH 环境变量中。本文将依次讲解版本选型、向导式安装要点、环境变量原理与手动配置步骤,以及终端运行验证和常见报错的排查方法,帮助读者建立稳固的本地运行环境。
一、准备工作与安装包版本选择
Python 3.7 是许多遗留生产系统、自动化测试脚本和特定机器学习库(例如部分历史版本的 TensorFlow)所依赖的稳定分支。在安装前,需要根据当前 Windows 系统的位数与补丁状态确定合适的安装介质:
- 系统版本支持:Python 3.7 官方支持 Windows 7 SP1、Windows 8、Windows 8.1、Windows 10 及 Windows 11。如果运行在 Windows 7 上,必须确认已升级到 Service Pack 1,并打上 KB2533623 或 KB3063858 补丁,否则安装后可能遇到缺少 API 动态链接库的错误。
- 架构选择:现代计算机通常为 64 位操作系统,应选择
Windows x86-64 executable installer;若设备属于特殊 32 位系统或需要对接 32 位专有动态链接库,则选择Windows x86 executable installer。 - 推荐维护版本:建议选用 Python 3.7 系列的最终维护包(例如 3.7.9),该版本修复了已知安全隐患并保持了良好的模块向下兼容性。
二、执行安装向导与核心选项解析
下载官方安装程序后,双击运行进入图形化向导界面。初次安装时,初始界面的勾选框决定了后续是否需要大量手动维护,因此需要特别留意:
以下是向导各关键阶段的操作细节说明:
- 勾选“Add Python 3.7 to PATH”:这是最基础也是最容易被忽略的设置。如果勾选,安装向导会在结束时自动将 Python 安装路径写入当前用户的环境变量;若未勾选,后续在命令行输入
python时系统将报告无法找到命令。 - 选择“Customize installation”:默认的“Install Now”会将 Python 安装在类似
C:\Users\<用户名>\AppData\Local\Programs\Python\Python37的深层目录下。该目录属于隐藏文件夹,当需要在控制台查找依赖或定位包文件时极不方便。选择自定义安装可以指定一个清晰简洁的路径,例如C:\Python37。 - 组件确认(Optional Features):在组件列表中,保持 Documentation、pip、tcl/tk and IDLE 以及 Python test suite 处于勾选状态,尤其是
pip工具,它是后续安装各类第三方扩展包的必要基础。 - 高级选项设置(Advanced Options):推荐勾选
Install for all users(为所有用户安装,安装路径会自动规整为短目录)以及Precompile standard library(预编译标准库,能微调模块加载效率)。 - 解除路径长度限制(Disable path length limit):在最后弹出的“Setup was successful”界面中,如果出现此按钮,建议以管理员权限点击。由于 Windows 历史上存在 260 字符的文件路径长度上限,安装某些深层嵌套的第三方 Python 依赖时容易发生文件无法读取的错误,点击此选项可以有效规避该问题。
三、理解环境变量与 PATH 寻址原理
为什么在命令提示符(CMD)或 PowerShell 中输入 python 或 pip 时,系统能够直接启动相应的可执行程序?这依赖于操作系统内部的 PATH 环境变量 寻址机制。
当用户在控制台中输入未指定全路径的命令时,Windows 会遵循如下步骤进行寻址:
- 首先在当前工作目录(Current Directory)中查找是否存在同名可执行文件。
- 若当前目录不存在,系统将读取系统与用户变量中的 PATH 字符串,该字符串包含由分号(在旧版界面中)或多行列表(在现代 Windows 10/11 界面中)组成的目录序列。
- 系统依次进入每个目录,寻找与输入名称相符的
.exe、.bat、.cmd等扩展名程序。 - 一旦在某个目录找到目标,立即加载执行并终止搜索;若遍历完所有路径均未命中,控制台便抛出
'xxx' 不是内部或外部命令,也不是可运行的程序或批处理文件。
因此,配置 Python 的环境变量,本质上就是将 Python 根目录和 Scripts 目录这两个绝对路径添加至系统的 PATH 列表中。
四、手动配置与补全环境变量步骤
如果在安装向导中遗漏了“Add Python 3.7 to PATH”勾选框,或者需要为多用户环境设置全局变量,可通过 Windows 系统属性界面进行手动配置。
1. 打开环境变量管理窗口
进入配置窗口的最快捷方法如下:
- 按下快捷键组合
Win + R打开“运行”对话框。 - 在输入框中输入
sysdm.cpl并按下回车,直接启动“系统属性”面板。 - 在弹出的面板中切换至顶部“高级”选项卡,点击右下角的“环境变量(N)...”按钮。
2. 定位并编辑 Path 变量
在环境变量窗口中,分为“用户变量”与“系统变量”上下两个区域:
- 如果希望当前设备的所有 Windows 账户都能使用 Python 3.7,在下方系统变量中找到名为
Path的变量行,选中后点击“编辑(I)...”。 - 在弹出的编辑列表中,点击右侧的“新建(N)”按钮。
- 输入 Python 3.7 的安装主目录:
C:\Python37\(以实际安装路径为准)。 - 再次点击“新建(N)”,输入 Scripts 目录:
C:\Python37\Scripts\。 - 如果系统中同时存在其他更高版本的 Python(例如 Python 3.10),而当前需要优先调用 Python 3.7,可通过右侧的“上移(U)”按钮将这两条记录调整到其他 Python 路径上方。
关键提醒:完成编辑后,必须连续点击三次“确定”按钮关闭所有弹出的属性窗口,修改才会持久化写入注册表。如果直接点击取消或右上角关闭,设置将不会保存。
五、终端可用性验证与 pip 基础配置
完成向导安装或手动修改环境变量后,必须通过控制台验证配置是否真实生效。请注意:已打开的命令行窗口无法感知更新后的环境变量,必须重新开启一个新的窗口。
1. 启动新终端并执行版本检查
按下 Win + R,输入 cmd 回车启动新的命令提示符,分别执行以下命令:
C:\Users\Admin> python --version
Python 3.7.9
C:\Users\Admin> pip --version
pip 20.1.1 from C:\Python37\lib\site-packages\pip (python 3.7)
若终端正确输出形如 Python 3.7.x 以及 pip x.x.x from C:\Python37... 的回显,说明主程序与包管理器的环境变量均已配置就绪。
2. 执行交互式测试代码
在终端直接输入 python 回车,进入 Python 交互式 REPL 环境,尝试运行单行打印语句与数学计算:
C:\Users\Admin> python
Python 3.7.9 (tags/v3.7.9:13c1b747c4, Aug 17 2020, 16:30:00) [MSC v.1900 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> print("Python 3.7 on Windows works properly.")
Python 3.7 on Windows works properly.
>>> 2 ** 10
1024
>>> exit()
测试完成后,输入 exit() 或按下 Ctrl + Z 后回车退出交互环境。
3. 配置 pip 国内镜像源(提升下载速率)
Python 3.7 默认自带的 pip 版本相对较早,且访问官方 PyPI 源可能存在连接不稳定或速度缓慢的情况。可通过单条命令永久配置国内镜像源(例如清华大学开源镜像站):
C:\Users\Admin> pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
Writing to C:\Users\Admin\AppData\Roaming\pip\pip.ini
配置后,可尝试升级 pip 工具或安装常规第三方库:
C:\Users\Admin> python -m pip install --upgrade pip
六、常见安装与运行故障排查
在实际配置过程中,由于 Windows 历史系统设置或多版本共存问题,可能会出现若干典型异常。下方的决策树归纳了最常见的三类故障及其排查修复路径:
故障排查要点清单:
| 现象描述 | 可能原因 | 具体解决步骤 |
|---|---|---|
命令未识别'python' 不是内部或外部命令 |
安装时未勾选 PATH 选项;或添加路径后未重启终端。 |
1. 打开系统属性添加 C:\Python37 和 C:\Python37\Scripts 到 Path;2. 关闭所有现存 CMD / PowerShell 窗口并重新启动。 |
| 跳转应用商店 输入 python 打开 Microsoft Store |
Windows 10/11 自带的应用执行别名接管了空命令。 | 进入系统【设置】→【应用】→【应用和功能】→【应用执行别名】,关闭两项 python.exe 和 python3.exe。 |
| 版本不匹配 显示 Python 3.8 / 3.10 等非 3.7 版本 |
多版本共存,其它版本的 Path 记录在检索顺序中位于最前。 |
1. 调整 Path 列表中 Python 3.7 路径的顺序,上移至首位; 2. 亦可在终端使用 py -3.7 启动指定版本的解释器。
|
缺少 DLL 报错api-ms-win-crt-runtime...dll 缺失 |
Windows 7 / 8 缺失微软 Visual C++ 运行库组件。 | 下载并安装“Visual C++ Redistributable for Visual Studio 2015-2019”运行库安装包,补齐基础运行依赖。 |
通过遵循以上规范步骤,读者可在 Windows 环境下建立起清晰、可控的 Python 3.7 运行与开发环境。后续无论是开发特定遗留系统工具,还是利用 pip 搭建专用脚本体系,均能保持稳定高效的运行状态。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









