Windows系统Python下载安装及环境变量配置教程

Elena
Elena
发布时间:2026-10-30| 11人浏览过
原创

针对Windows操作系统的Python官方安装包下载、向导安装关键选项说明、手动配置Path环境变量步骤以及终端验证与常见排查方法的详细教程。

在 Windows 环境下部署 Python 开发环境,核心目标是完成两项工作:一是获取官方匹配系统架构的安装程序并解压安装解释器核心组件;二是将 Python 主执行文件目录与包管理器脚本目录写入系统 Path 环境变量。完成这两步后,即可在任意命令提示符或 PowerShell 终端中直接调用 python 与 pip 工具。

一、下载前的系统确认与安装包选择

在下载 Python 安装包之前,需要先确认当前操作系统的位数规格。现代计算机通常运行 64 位(x64 / AMD64)的 Windows 10 或 Windows 11 系统。通过快捷键 Win + Pause/Break 或在“设置 > 系统 > 关于”中即可查看“系统类型”。

通过浏览器访问 Python 官方网站下载区(python.org/downloads/windows/),官方针对 Windows 提供了多种不同形态的分发包,主要包括以下两类:

  • Windows installer (64-bit):推荐使用的标准离线安装程序(扩展名为 .exe)。向导内包含完整的 Python 解释器、标准库、pip 包管理器、IDLE 集成环境、文档及自动写入环境变量功能,适合常规开发与学习使用。
  • Windows embeddable package (64-bit):便携式精简压缩包(扩展名为 .zip)。该版本不包含 pip,也没有安装引导向导,主要用于将 Python 运行时直接打包嵌入到第三方商业应用程序中,不适合初学者日常独立使用。
Windows系统Python下载安装及环境变量配置教程
图 1:Windows 系统下 Python 安装前准备与安装包类型选择流程

二、运行安装向导与关键选项设置

下载完成后,双击运行 python-3.x.x-amd64.exe 安装文件。安装首页展示了决定后续能否顺畅使用 Python 的关键选项,切勿直接点击默认的下一步。

1. 勾选“Add python.exe to PATH”

在安装向导最底部,有一项名为 Add python.exe to PATH(部分早期版本标为 Add Python 3.x to PATH)的复选框。该项默认处于未勾选状态。必须在此处主动勾选。勾选后,安装程序会在完成文件复制后,自动把 Python 主程序目录与 Scripts 目录写入当前系统的环境变量,省去后续手动修改系统设置的操作。

2. “Install Now” 与 “Customize installation” 的关键差异

向导提供了两种安装方式,两者在安装路径、权限范围和目录可读性上存在显著差异:

对比维度 Install Now(立即安装) Customize installation(自定义安装)
安装路径 C:\Users\用户名\AppData\Local\Programs\Python\Python3x 用户自行指定,推荐如 C:\Python312 或 D:\Develop\Python312
生效用户范围 通常仅对当前 Windows 登录账户生效 可勾选“Install Python for all users”对整机全用户生效
路径易用性 路径层级深且包含隐藏文件夹 AppData,命令行查找不直观 路径简短规整,无空格与特殊符号,方便后续配置与排错
组件选择 直接安装预设的标准套件 可明确确认 pip、IDLE、文档及工具包的安装状态

对于个人开发机器,推荐选择 Customize installation(自定义安装)。在第二页“Optional Features”中,保持 Documentation、pip、tcl/tk、Python test suite 及 py launcher 全部勾选;点击“Next”进入“Advanced Options”高级选项页,建议勾选以下项目:

  • Install Python for all users:勾选此项可将安装范围扩展至全系统,同时安装路径会自动规范为类似 C:\Program Files\Python312 或根目录形式。
  • Associate files with Python:勾选,使 .py 脚本文件能与 Python 解释器建立关联。
  • Create shortcuts for installed applications:勾选,在开始菜单生成启动快捷方式。
  • Add Python to environment variables:必须保持勾选,确保自动同步环境变量。
  • Customize install location:将安装路径更改为一个清晰的短路径,例如 C:\Python312。注意:路径中严禁包含中文字符或空格,以避免后续第三方库编译或脚本运行时的路径转义异常。

点击“Install”并授予管理员权限,等待进度条走完。安装完成后,如果界面出现 Disable path length limit(解除 MAX_PATH 260字符路径限制)选项,建议直接点击该按钮。这能避免后续使用 pip 安装依赖包路径过长时引发的系统报错。

Windows系统Python下载安装及环境变量配置教程
图 2:Python 安装向导关键安装模式与核心选项对比

三、手动配置系统环境变量 Path

如果在安装时漏选了“Add python.exe to PATH”,或者后续移动了 Python 安装目录,Windows 终端将无法识别 python 命令。此时需要通过系统控制台手动补充环境变量。

1. 环境变量 Path 的工作原理

当用户在命令提示符或 PowerShell 中输入 python 或 pip 并回车时,Windows 系统的执行逻辑如下:首先在“当前工作目录”中查找是否存在同名可执行文件;如果不存在,系统会逐行检索环境变量 Path 中登记的文件夹列表。一旦在某一个文件夹内找到了 python.exe,系统就立即加载执行该程序;若遍历完所有路径均未命中,系统则抛出报错。

因此,配置环境变量的本质,就是把存放 python.exe 和 pip.exe 的绝对文件夹路径追加到系统 Path 列表中。

2. 手动配置的具体操作步骤

  1. 打开环境变量设置窗口:
    • 方式一:使用快捷键 Win + R 打开“运行”对话框,输入 sysdm.cpl 并回车,在打开的“系统属性”窗口中切换到“高级”选项卡,点击右下角的“环境变量”按钮。
    • 方式二:右键点击桌面或文件资源管理器中的“此电脑”,选择“属性”,点击“高级系统设置”,进入“环境变量”。
  2. 定位 Path 变量:

    环境变量窗口分为两栏:上半部分为“当前用户变量”,下半部分为“系统变量”。

    • 用户变量中的 Path:仅对当前登录的 Windows 用户账号有效。
    • 系统变量中的 Path:对计算机上的所有系统用户统一生效(推荐在此修改)。

    在“系统变量”列表中找到名为 Path(大小写均可)的一行,选中后点击“编辑”。

  3. 添加 Python 的两个关键路径:

    在弹出的“编辑环境变量”窗口中,点击右侧的“新建”按钮,依次输入以下两个路径(请根据实际安装目录填写):

    • Python 主程序目录:例如 C:\Python312\(该目录下包含 python.exe)
    • Python 脚本与工具目录:例如 C:\Python312\Scripts\(该目录下包含 pip.exe)
  4. 确认保存:

    点击“编辑环境变量”窗口的“确定”,再点击“环境变量”主窗口的“确定”,最后点击“系统属性”窗口的“确定”。必须连续点击三次“确定”,修改才会保存到注册表。

注意:如果之前已打开命令提示符(CMD)或 PowerShell 窗口,修改环境变量后这些旧窗口不会自动同步新配置。必须关闭所有已打开的终端窗口并重新打开,新配置才会生效。

Windows系统Python下载安装及环境变量配置教程
图 3:Windows Path 环境变量检索逻辑与目录映射原理

四、安装与环境验证

配置完成后,必须通过终端验证安装是否完整有效。按下 Win + R,输入 cmd 打开命令提示符,依次执行以下测试命令。

1. 验证 Python 解释器

执行测试命令:
python --version
终端预期输出示例(具体版本号取决于安装的实际版本):
Python 3.12.3

2. 验证 pip 包管理工具

执行测试命令:
pip --version
终端预期输出示例:
pip 24.0 from C:\Python312\Lib\site-packages\pip (python 3.12)

若输出了 pip 版本号以及正确的安装目录路径,说明 Scripts 环境变量已正确加载。

3. 交互式环境测试

在终端中输入 python 进入交互式命令行:
python
进入 REPL 后的会话输出与交互示例:
Python 3.12.3 (tags/v3.12.3:f6650f9, Apr  9 2024, 14:05:25) [MSC v.1938 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> print("Hello, Python!")
Hello, Python!
>>> exit()

在提示符 >>> 后输入 Python 代码并成功返回结果,最后调用 exit() 退出交互环境,表明 Python 运行时部署完毕。

五、常见问题排查与解决方法

在实际配置过程中,初学者常会遇到以下两类典型异常:

1. 提示“'python' 不是内部或外部命令,也不是可运行的程序”

原因分析:

  • 环境变量配置未保存或漏填了末尾路径。
  • 修改环境变量后,未重启命令提示符窗口,仍在使用旧的环境变量快照。
  • 填写的文件夹路径存在拼写错误(如漏写了冒号或斜杠)。

解决办法:重新核对“系统属性 > 环境变量 > Path”中的路径,确保完全匹配实际安装的文件夹绝对路径,保存退出后,关闭当前 CMD 窗口并重新打开再次测试。

2. 输入 python 后直接跳转到 Windows 应用商店(Microsoft Store)

原因分析:Windows 10/11 系统内置了名为“应用执行别名”(App Execution Aliases)的重定向功能。当系统检测到尚未配置全局 Python 或者该别名优先级高于用户配置路径时,调用 python.exe 会默认打开微软应用商店提示安装。

解决办法:

  1. 打开 Windows“设置”窗口(快捷键 Win + I)。
  2. 进入“应用” > “高级应用设置” > “应用执行别名”。
  3. 在列表中找到名为 应用安装程序 (python.exe) 和 应用安装程序 (python3.exe) 的两个开关,将其手动切换为“关”。
  4. 关闭设置后,重新打开命令行窗口执行 python --version 即可恢复正常。
Windows系统Python下载安装及环境变量配置教程
图 4:Windows 系统 Python 下载、安装、环境变量配置与验证排错全景清单

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。