Python官网下载与安装教程:Windows系统完整步骤
本教程详细讲解在Windows 10/11系统下从Python官方网站下载、安装与配置Python运行环境的完整步骤,涵盖64位安装包选型、Add to PATH关键配置、Disable path length limit长路径解除、终端验证与常见报错排查。
一、下载前准备:确认 Windows 系统架构与系统版本要求
在前往官网下载之前,需要明确当前计算机的处理器架构与 Windows 系统版本。盲目下载可能导致安装了 32 位运行库而无法充分利用系统内存,或者错选了 ARM64 安装包而导致程序无法在常规电脑上运行。
1. 查看系统类型:在键盘上按下快捷键 Win + I 打开“Windows 设置”,依次点击“系统” > “关于”(或直接在键盘上按下 Win + Pause)。在“设备规格”一栏中找到“系统类型”:
- 若显示“64 位操作系统,基于 x64 的处理器”,则对应下载 Windows installer (64-bit),这是目前绝大多数现代 PC 的标准架构。
- 若显示“基于 ARM 的处理器”(如部分 Surface Pro 或搭载骁龙处理器的设备),则需选择 Windows installer (ARM64)。
2. 明确操作系统兼容边界:从 Python 3.9 开始,Python 官方已正式停止对 Windows 7 及更早版本操作系统的支持。若计算机运行的是 Windows 10 或 Windows 11,可放心安装最新的稳定发布版本(如 Python 3.12 或 3.11)。
二、访问 Python 官网与挑选适用的 Windows 安装程序
Python 官方唯一的全球官方分发网站是 https://www.python.org/。为了保证环境的安全与纯净,不应通过任何第三方下载站、软件管家或打包整合包进行安装,以避免遭遇广告捆绑、修改版运行时或恶意代码风险。
访问官网主页后,挑选安装包主要有两种途径:
- 快速通道:将鼠标悬停在顶部导航栏的“Downloads”菜单上,向导卡片右侧会自动识别 Windows 系统,并显示当前最新的稳定版本下载按钮(例如“Download for Windows: Python 3.12.x”)。点击该黄色按钮即可直接获取 64 位标准安装程序。
- 精细列表通道:直接在浏览器地址栏访问
https://www.python.org/downloads/windows/,进入专为 Windows 打造的版本归档页。在“Stable Releases”列表中,可以看到每个版本的详细发布清单。
在 Windows 归档列表中,同一个 Python 版本通常会列出四种不同形态的下载文件。初学者极易混淆,具体辨析如下:
| 文件类型名称 | 打包后缀 | 包含组件 | 选型决策与适用对象 |
|---|---|---|---|
| Windows installer (64-bit) | .exe |
解释器 + pip + IDLE + 文档 + PATH注入器 | 强烈推荐。绝大多数 Intel/AMD 64位 Windows 用户的标准首选。 |
| Windows installer (ARM64) | .exe |
ARM64 原生运行时 + pip + 工具套件 | 硬件专属。仅适用于高通骁龙等 ARM 架构的 Windows 笔记本。 |
| Windows embeddable package (64-bit) | .zip |
极简核心 DLL + python.exe(无 pip、无环境注册) | 切勿错选。仅供作为宿主软件内部嵌入脚本调用,不支持普通开发。 |
| Windows installer (32-bit) | .exe |
32位完整套件(单进程内存受限于 4GB) | 遗留系统兼容。仅供 32 位老旧系统或依赖 32 位专有 C 驱动时选用。 |
三、执行安装向导:核心选项配置与关键注意事项
下载完成后,在浏览器的下载目录中找到名为 python-3.12.x-amd64.exe(具体文件名随小版本号变化)的文件,鼠标右键点击并选择“以管理员身份运行”启动安装向导。
1. 勾选关键环境变量(重中之重)
双击启动向导后,首先看到的是“Install Python”欢迎界面。在界面最底部,有两项复选框:
[x] Use admin privileges when installing py.exe(默认通常勾选,保持即可)[x] Add python.exe to PATH(极其重要:默认通常未勾选,必须手动勾选!)
PATH 是 Windows 系统用于搜寻可执行文件的全局路径清单。如果漏勾此项,系统不会将 Python 的安装目录与脚本目录写入全局变量,导致后续在命令提示符或 PowerShell 中键入 python 或 pip 时,系统直接报出“不是内部或外部命令”的错误。
2. 选择安装方式:Install Now vs Customize installation
在欢迎界面中间,有两种安装路径模式可供选择:
-
方式一:选择“Install Now”(推荐初学者与多数用户)
点击后将直接安装到当前 Windows 用户的专属 AppData 目录下(默认路径为:C:\Users\<用户名>\AppData\Local\Programs\Python\Python3xx)。该方式自动安装 IDLE 编辑器、pip 工具套件及标准库,无需额外调整参数。 -
方式二:选择“Customize installation”(自定义高级安装)
若希望将 Python 安装到自定义的磁盘位置(例如安装到固态硬盘的C:\Python312),可点击该选项:- 在“Optional Features”(可选功能)界面,保持 Documentation、pip、tcl/tk and IDLE、Python test suite 与 py launcher 全部勾选,点击 Next。
- 在“Advanced Options”(高级选项)界面,建议勾选
Install Python for all users(为所有用户安装),此时下方的“Customize install location”输入框会自动变更为类似C:\Program Files\Python312。 - 注意:若自行修改路径,安装路径中绝对不能包含中文字符或半角空格,以防日后编译原生 C 扩展包时因路径转义解析失败而报错。
3. 解除 Windows 260 字符长路径限制(Disable path length limit)
当进度条走完,向导呈现“Setup was successful”(安装成功)页面时,界面中间下方常会出现一个带有管理员小盾牌图标的选项:
Disable path length limit(禁用路径长度限制)。
Windows 文件系统在传统上对文件绝对路径有 260 个字符的长度上限(MAX_PATH)。在 Python 开发中,许多第三方包及其依赖具有极其深层的目录嵌套结构,一旦超过 260 字符,解压或导入时便会触发 FileNotFoundError。强烈建议直接点击此选项,并在弹出的用户账户控制(UAC)对话框中点击“是”授予提权,随后点击“Close”关闭安装器。
四、验证安装结果:终端命令与交互测试
安装程序关闭后,必须在终端环境中对解释器及包管理系统进行验证。
如果命令行窗口在安装完成之前就已经处于打开状态,该窗口将无法读取安装程序刚写入系统的最新 PATH 环境变量。务必关闭旧终端,重新呼出全新终端进行测试。
按下快捷键 Win + R,在运行框中输入 cmd 或 powershell 并回车打开终端,依次执行下列验证步骤:
1. 验证 Python 解释器版本
python --version
Python 3.12.4
能够正常显示版本号即代表系统已成功从全局 PATH 中检索到 python.exe。
2. 验证 pip 包管理工具
pip --version
pip 24.0 from C:\Users\Username\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)
输出中不仅显示 pip 版本,还清晰指明了该 pip 所绑定的 Python 安装目录,确认第三方依赖库安装功能就绪。
3. 进入交互式解释器(REPL)验证运行
在终端直接输入 python 并回车,终端提示符将变为三个大于号 >>>,标志着成功进入 Python 交互运行环境:
C:\Users\Username> python
Python 3.12.4 (tags/v3.12.4:8e8a4ba, Jun 6 2024, 19:30:16) [MSC v.1940 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> print("Hello, Python on Windows!")
Hello, Python on Windows!
>>> exit()
输入测试打印语句后按回车,控制台立即输出了相应内容;输入 exit() 或按下 Ctrl + Z 后回车,即可安全退出交互模式回到系统命令行。
五、常见故障排查:PATH 缺失与微软商店别名冲突
在初次安装过程中,最常遭遇的两类异常均与 Windows 系统的指令分发机制相关。
故障一:提示“'python' 不是内部或外部命令,也不是可运行的程序”
排查依据:这通常说明当前终端环境中没有找到 python.exe 的注册路径。
修复方法(两种路径):
-
方法 A(通过安装器自动修复,推荐):重新双击运行下载好的
python-3.12.x-amd64.exe安装包。安装器检测到系统已安装该程序后,会显示“Modify”、“Repair”、“Uninstall”三个按钮。点击 Modify,在第一页保持全选点击 Next,在第二页务必勾选 Add Python to environment variables,点击 Modify 即可自动补全环境变量配置。 -
方法 B(手动添加系统环境变量):
- 按下快捷键 Win + R,输入
sysdm.cpl回车打开“系统属性”。 - 切换到“高级”选项卡,点击底部的“环境变量”按钮。
- 在“用户变量”或“系统变量”区域中找到名为
Path的变量,选中后点击“编辑”。 - 在弹出的编辑窗口中点击“新建”,根据实际安装位置填入 Python 根目录与 Scripts 目录(以默认安装路径为例):
C:\Users\<你的用户名>\AppData\Local\Programs\Python\Python312\
C:\Users\<你的用户名>\AppData\Local\Programs\Python\Python312\Scripts\ - 逐层点击“确定”保存设置,随后关闭所有现存的终端窗口并重新打开测试。
- 按下快捷键 Win + R,输入
故障二:终端输入 python 后未进入解释器,而是弹出了微软应用商店(Microsoft Store)
排查依据:Windows 10/11 系统在全局路径中默认内置了一个 0 字节的 python.exe 占位桩(位于 %LOCALAPPDATA%\Microsoft\WindowsApps)。如果实际安装路径未在系统变量中排在该占位桩的前面,系统就会触发默认的应用别名,自动唤起微软商店推荐下载。
修复方法(关闭应用执行别名):
- 打开 Windows“设置”(快捷键 Win + I)。
- 依次点击“应用” > “高级应用设置” > “应用执行别名”(在部分 Windows 10 版本中为“应用和功能”右侧的“应用执行别名”链接)。
- 在应用列表中向下滚动,找到两项名为“应用安装程序 (python.exe)”与“应用安装程序 (python3.exe)”的项目。
- 将这两项对应的开关全部切换为“关”。
- 重新打开终端输入
python --version,系统即可绕过微软商店桩,直接调用真实安装的 Python 解释器。
六、初始环境验收清单与后续配置建议
为了确保开发环境不仅“能启动”,而且“能稳定安装依赖”,应按照下列五维指标对整套环境进行最终交付验收。
后续开发配置建议
在完成以上步骤后,本地基础环境已全部就绪。在进入实际编程前,建议实施以下两项生产最佳实践:
1. 配置国内 PyPI 镜像加速(提升第三方库下载速度):在 Windows 终端中执行以下命令,将 pip 默认索引地址切换为清华大学开源镜像源,大幅提升后期安装 requests、numpy、pandas 等模块的下载稳定性:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
Writing to C:\Users\Username\AppData\Roaming\pip\pip.ini
2. 使用虚拟环境隔离项目:为避免不同项目之间的依赖版本发生冲突,不建议将所有第三方库都直接安装到全局环境。建议在每个项目工程目录下,使用 Python 内置的 venv 模块创建独立虚拟环境:
# 创建名为 .venv 的独立虚拟环境
python -m venv .venv
# 在 Windows PowerShell 中激活虚拟环境
.\.venv\Scripts\Activate.ps1
当终端前缀出现 (.venv) 标识时,所有通过 pip install 安装的库都将精准封装在当前项目目录下,保障系统全局环境的整洁与可维护性。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









