Windows系统安装Python 3.7并配置环境变量
一、安装前准备与版本匹配
Python 3.7 是 Python 语言演进中的一个经典长期版本,引入了数据类(Dataclasses)与更高效的字典结构。尽管 Python 官方已于 2023 年终止对 3.7 系列的官方支持,但在许多特定工程维护、深度学习旧版本库(例如旧版 TensorFlow 1.15)或工控场景中,Python 3.7 依然不可替代。
在安装之前,需要明确当前 Windows 操作系统的体系结构与版本限制:
- 操作系统版本要求:Windows 10 与 Windows 11 原生完全支持 Python 3.7;Windows 7 操作系统必须确认已升级到 Service Pack 1(SP1)并且安装了系统补丁 KB2533623,否则在安装末尾或运行解释器时可能出现缺少
api-ms-win-crt-runtime-l1-1-0.dll的系统报错;Windows XP 与 Vista 则完全不支持 Python 3.7。 - 体系结构匹配:绝大多数现代计算机均采用 64 位(x86-64 / AMD64)架构,应当选择对应的 64 位安装包;若目标机器属于特定的 32 位工业平板或工控机,则需选择 32 位(x86)安装程序。
- 最终维护补丁版本:Python 3.7 系列的最终可执行安装版本为 Python 3.7.9(发布于 2020 年 8 月,其后的 3.7.10 至 3.7.17 仅提供纯源码安全补丁,未发布官方 Windows 二进制安装程序)。
二、下载官方安装程序
为了保证软件完整性与安全性,建议始终从 Python 官方软件仓库(python.org)获取安装包。对于 64 位的现代 Windows 系统,推荐下载的是可执行独立离线安装程序:
- 官方稳定版安装包名称:
python-3.7.9-amd64.exe(64 位完整安装包,文件大小约 26MB) - 32 位安装包名称:
python-3.7.9.exe(仅针对 32 位 Windows 系统)
-webbased.exe 后缀的网络安装包,该安装程序在运行过程中需要实时连接境外服务器拉取组件,在国内网络环境下容易出现下载超时或连接中断;也不要下载 -embed-amd64.zip 嵌入式免安装包,因为该包移除了 pip 包管理器与标准头文件,仅适合作为独立软件打包运行载体。
三、执行安装向导与关键选项设置
下载完成后,建议右键点击 python-3.7.9-amd64.exe,选择“以管理员身份运行”。安装向导主要分为两个关键配置页面:初始引导界面与自定义安装选项。
1. 初始向导页面的核心勾选项
在打开的第一个安装窗口中,界面底部包含两个极其重要的复选框:
- Install launcher for all users (recommended):保持默认勾选。这会在系统目录中安装
py.exe启动器,为后续管理多个 Python 版本提供极大便利。 - Add Python 3.7 to PATH:必须手动勾选此项!默认情况下该项是未选中的。勾选后,安装程序会在安装过程中自动将 Python 及其脚本目录写入当前用户的环境变量中。如果遗漏此步,在安装后打开命令行将无法直接识别
python命令。
勾选完毕后,不要直接点击“Install Now”,因为默认路径通常极其冗长(例如 C:\Users\用户名\AppData\Local\Programs\Python\Python37),且 AppData 是隐藏文件夹,后续配置扩展包或查找动态库极为不便。推荐点击下方的“Customize installation”进入自定义模式。
2. 可选特性(Optional Features)确认
进入第二页“Optional Features”,保持全部默认勾选状态即可:
Documentation:离线帮助文档。pip:Python 官方第三方包管理工具(必须勾选)。tcl/tk and IDLE:图形界面支持库与轻量级 Python 编辑器 IDLE。Python test suite:标准库测试套件。py launcher与for all users:全局版本分发启动器。
确认无误后点击“Next”。
3. 高级选项(Advanced Options)与安装目录定制
在“Advanced Options”界面中:
- 勾选 “Install for all users”:这会将安装范围从单用户扩展为整机所有用户,此时安装路径将脱离用户的 AppData 目录。
- 检查并修改 “Customize install location”:将默认路径修改为简洁明了的根目录路径,例如:
C:\Python37或D:\Python\Python37。请严格确保安装路径中不含有任何中文、空格或特殊字符。
点击“Install”开始复制文件。在进度条走完后,如果系统提示“Disable path length limit”(解除 MAX_PATH 260 字符限制),点击该按钮进行解除,最后点击“Close”完成安装。
四、环境变量 Path 的结构与手动配置流程
如果在安装时勾选了“Add Python 3.7 to PATH”,向导已经自动把相关路径写入了系统或用户变量中。然而在许多现实场景中,例如安装时遗漏了勾选、系统存在旧版本残留覆盖、或者因权限问题未能成功写入,读者必须掌握手动配置与校验环境变量的具体方法。
1. 为什么需要配置 Path?
当用户在 Windows 命令行(CMD)或 PowerShell 中敲入 python 或 pip 时,操作系统本身并不知道这两个程序存放在硬盘的哪个深层文件夹。Windows 会依次在当前所在目录、系统变量 Path、用户变量 Path 中逐项寻找同名的 .exe 或可执行文件。只有将 Python 所在的文件夹登记在 Path 列表中,系统才能在任意终端路径下调起解释器。
对于 Python 3.7,必须向 Path 变量中注入两个核心目录:
| 目录类型 | 默认推荐路径示例 | 核心职责与包含的文件 |
|---|---|---|
| 主程序根目录 | C:\Python37\ |
包含 python.exe(交互控制台)、pythonw.exe(后台静默运行)、核心动态库及标准库模块。 |
| 脚本与工具目录 | C:\Python37\Scripts\ |
包含 pip.exe(包管理工具)、easy_install.exe 以及未来通过 pip 安装的所有命令行可执行工具(如 wheel、pytest、flake8 等)。 |
C:\Python37\Scripts\ 应当排在 C:\Python37\ 之前,且二者均应当尽量前移,避开系统预装的 WindowsApps 别名重定向干扰。
2. Windows 10 / Windows 11 手动配置步骤
- 使用快捷键
Win + R打开“运行”窗口,输入sysdm.cpl并按下回车,直接调出“系统属性”面板。 - 在弹出的对话框顶部切换到“高级”选项卡,点击底部的“环境变量(N)...”按钮。
- 在环境变量面板中,通常推荐在下方的“系统变量”区域中寻找名为
Path的变量(修改系统变量对所有登录用户均生效;若无整机管理员权限,也可在上方“用户变量”的Path中修改)。 - 双击
Path,在弹出的多行编辑窗口中:- 点击右侧的“新建”按钮,输入主程序根目录:
C:\Python37\ - 再次点击“新建”按钮,输入脚本工具目录:
C:\Python37\Scripts\ - 利用右侧的“上移”按钮,将这两项移动到靠前的位置。
- 点击右侧的“新建”按钮,输入主程序根目录:
- 依次点击各个窗口的“确定”按钮完成保存(通常需要连续点击三次确定)。
3. Windows 7 单行格式说明
如果在 Windows 7 系统上配置,点击编辑 Path 后出现的是一个单行输入框,各个路径之间使用英文半角分号(;)进行分隔。可以在变量值末尾追加:;C:\Python37\;C:\Python37\Scripts\(注意不要删除已有内容,确保每一段前后有分号隔开)。
五、终端验证与基础运行测试
完成安装与环境变量配置后,必须关闭所有当前已打开的 CMD 或 PowerShell 窗口,并重新打开一个新的终端。因为已经运行的终端进程不会动态加载最新的环境变量快照。
1. 验证 Python 解释器
按下快捷键 Win + R,输入 cmd 回车启动命令提示符,执行版本查询命令:
C:\Users\Admin> python --version
Python 3.7.9
如果控制台正确输出了 Python 3.7.9,说明 Python 解释器主程序及其环境变量已成功生效。
2. 验证 pip 包管理器
在同一个终端中执行:
C:\Users\Admin> pip --version
pip 20.1.1 from C:\Python37\lib\site-packages\pip (python 3.7)
输出结果中明确显示了 pip 的版本号以及所依附的 Python 3.7 安装路径,证明 C:\Python37\Scripts\ 目录已经连通。
3. 运行交互式命令测试
直接输入 python 进入交互式 REPL 控制台:
C:\Users\Admin> python
Python 3.7.9 (tags/v3.7.9:13c94747c7, Aug 17 2020, 18:58:18) [MSC v.1900 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> print("Hello from Python 3.7!")
Hello from Python 3.7!
>>> import sys
>>> sys.executable
'C:\\Python37\\python.exe'
>>> exit()
执行 exit() 或按下 Ctrl + Z 加回车即可退出交互式环境,返回 Windows 命令行提示符。
六、多版本共存管理与常见问题排查
在实际生产与开发环境中,许多开发者的计算机上同时安装了 Python 3.10、Python 3.11 或 Python 3.12,此时如何精确调用 Python 3.7 并避免命令冲突,是环境配置的关键环节。
1. 利用 Windows 原生 py 启动器调度特定版本
如果在安装时保留了 py launcher,Windows 会在 C:\Windows\py.exe 中驻留官方版本调度器。无论系统的 Path 环境变量首选是哪个 Python 版本,都可以通过启动器精准指定版本:
# 查看当前系统已识别的所有 Python 版本
C:\Users\Admin> py --list
-V:3.11 * C:\Python311\python.exe
-V:3.7 C:\Python37\python.exe
# 指定使用 3.7 运行交互环境或脚本
C:\Users\Admin> py -3.7 -V
Python 3.7.9
# 指定使用 3.7 的 pip 安装模块
C:\Users\Admin> py -3.7 -m pip install requests
2. 为项目建立专属的 Python 3.7 虚拟环境
为了防止不同项目之间的第三方库互相污染,推荐在具体工程目录下创建独立的虚拟环境(venv):
# 进入目标项目目录
cd D:\Projects\legacy_ai
# 创建基于 Python 3.7 的虚拟环境
py -3.7 -m venv venv37
# 激活虚拟环境
venv37\Scripts\activate
# 此时控制台前缀将出现 (venv37),直接使用 python 与 pip 均锁定在 3.7 环境中
(venv37) D:\Projects\legacy_ai> python -V
Python 3.7.9
3. 常见排查与故障处理
- 现象 1:输入 python 后直接弹出了微软应用商店(Microsoft Store)界面。
原因:Windows 10/11 在用户变量 Path 中预设了%USERPROFILE%\AppData\Local\Microsoft\WindowsApps,其中包含了指向应用商店的 0 字节python.exe占位快捷方式。
解决方法:打开 Windows“设置” -> “应用” -> “高级应用设置” -> “应用执行别名”,在列表中将“应用安装程序 (python.exe)”与“应用安装程序 (python3.exe)”对应的两个开关彻底关闭;同时检查系统环境变量,确保C:\Python37排在 WindowsApps 之前。 - 现象 2:pip 安装某些现代库时报错:“TLS/SSL 证书校验失败”或“Could not find a version”。
原因:Python 3.7 所附带的 pip 20.x 版本较老,且很多现代开源库已经放弃了对 Python 3.7 的 Wheel 预编译分发。
解决方法:通过以下命令先将 pip 升级到支持 3.7 的最终兼容版本,并切换国内稳定镜像源:python -m pip install --upgrade "pip<24.1" -i https://pypi.tuna.tsinghua.edu.cn/simple
七、总结
在 Windows 环境下正确安装与配置 Python 3.7,关键在于把握好以下几个核心节点:
- 精准选型:优先选用官方
python-3.7.9-amd64.exe离线完整安装包,Win 7 系统前置补齐系统更新与 VC++ 运行库。 - 向导定制:务必勾选
Add Python 3.7 to PATH,通过 Customize 模式将路径规整至如C:\Python37的无空格根目录,并在安装结束时解除系统长路径限制。 - 双路径环境变量:无论自动还是手动配置,确保
C:\Python37\与C:\Python37\Scripts\均妥善登记在 Path 列表中且优先级靠前。 - 共存与隔离:面对系统多版本共存,善用官方
py -3.7启动器与venv虚拟环境,能够彻底解决版本混乱与包依赖冲突。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













