Windows系统安装Python 3.7并配置环境变量

拾光
拾光
发布时间:2026-10-24 | 5人浏览过
原创
在 Windows 系统中安装 Python 3.7 并配置环境变量,是运行经典机器学习框架、旧版本企业软件系统或特定依赖库的基础工作。本文将以清晰直观的操作路径,完整梳理从官方安装包获取、图形向导定制选项、环境变量 Path 配置,到多版本共存调用与故障排查的完整流程。

一、安装前准备与版本匹配

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 二进制安装程序)。
Windows系统安装Python 3.7并配置环境变量
图 1:Python 3.7 系统兼容性矩阵与安装前准备架构

二、下载官方安装程序

为了保证软件完整性与安全性,建议始终从 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. 初始向导页面的核心勾选项

在打开的第一个安装窗口中,界面底部包含两个极其重要的复选框:

  1. Install launcher for all users (recommended):保持默认勾选。这会在系统目录中安装 py.exe 启动器,为后续管理多个 Python 版本提供极大便利。
  2. 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”完成安装。

Windows系统安装Python 3.7并配置环境变量
图 2:Python 3.7 安装向导全流程与关键配置选项

四、环境变量 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 等)。
重要顺序法则:在 Path 列表中,C:\Python37\Scripts\ 应当排在 C:\Python37\ 之前,且二者均应当尽量前移,避开系统预装的 WindowsApps 别名重定向干扰。

2. Windows 10 / Windows 11 手动配置步骤

  1. 使用快捷键 Win + R 打开“运行”窗口,输入 sysdm.cpl 并按下回车,直接调出“系统属性”面板。
  2. 在弹出的对话框顶部切换到“高级”选项卡,点击底部的“环境变量(N)...”按钮。
  3. 在环境变量面板中,通常推荐在下方的“系统变量”区域中寻找名为 Path 的变量(修改系统变量对所有登录用户均生效;若无整机管理员权限,也可在上方“用户变量”的 Path 中修改)。
  4. 双击 Path,在弹出的多行编辑窗口中:
    • 点击右侧的“新建”按钮,输入主程序根目录:C:\Python37\
    • 再次点击“新建”按钮,输入脚本工具目录:C:\Python37\Scripts\
    • 利用右侧的“上移”按钮,将这两项移动到靠前的位置。
  5. 依次点击各个窗口的“确定”按钮完成保存(通常需要连续点击三次确定)。

3. Windows 7 单行格式说明

如果在 Windows 7 系统上配置,点击编辑 Path 后出现的是一个单行输入框,各个路径之间使用英文半角分号(;)进行分隔。可以在变量值末尾追加:;C:\Python37\;C:\Python37\Scripts\(注意不要删除已有内容,确保每一段前后有分号隔开)。

Windows系统安装Python 3.7并配置环境变量
图 3:Windows 环境变量 Path 目录结构与命令查找逻辑拓扑

五、终端验证与基础运行测试

完成安装与环境变量配置后,必须关闭所有当前已打开的 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并配置环境变量
图 4:Python 3.7 验证矩阵与多版本共存调度体系

七、总结

在 Windows 环境下正确安装与配置 Python 3.7,关键在于把握好以下几个核心节点:

  1. 精准选型:优先选用官方 python-3.7.9-amd64.exe 离线完整安装包,Win 7 系统前置补齐系统更新与 VC++ 运行库。
  2. 向导定制:务必勾选 Add Python 3.7 to PATH,通过 Customize 模式将路径规整至如 C:\Python37 的无空格根目录,并在安装结束时解除系统长路径限制。
  3. 双路径环境变量:无论自动还是手动配置,确保 C:\Python37\ 与 C:\Python37\Scripts\ 均妥善登记在 Path 列表中且优先级靠前。
  4. 共存与隔离:面对系统多版本共存,善用官方 py -3.7 启动器与 venv 虚拟环境,能够彻底解决版本混乱与包依赖冲突。

本站声明

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

Python 相关产品和应用

全部下载

专题列表