Windows安装Python详细教程:下载、勾选Add to PATH及环境变量配置
Windows操作系统下安装Python的完整图文教程,详解从官网下载稳定版本、安装向导中勾选Add to PATH的核心意义、命令行验证步骤,以及遗漏勾选时的系统环境变量手动配置方法与常见报错排查。
在Windows系统上安装Python并不复杂,但其中最关键的一步是让系统能够识别并定位Python的执行程序。完整的安装过程分为三个阶段:从官方网站获取对应位数的安装程序、在安装向导中勾选“Add python.exe to PATH”、以及在终端中进行验证。如果在安装时漏掉了该选项,也可以通过手动配置系统环境变量来完成补救。本文将按实际操作路径逐项讲解。
一、下载 Python 官方安装程序
获取安装包的第一原则是从 Python 官方网站下载,避免使用第三方应用市场或下载站,以确保程序的完整性与纯净度。
1. 确认系统架构与版本选择
在浏览器中输入官方主页 https://www.python.org,将鼠标悬停在顶部导航栏的“Downloads”菜单上。页面通常会自动识别出当前为 Windows 系统并给出推荐版本的下载按钮。但为了确保拿到最适配的安装文件,建议点击“Windows”子菜单进入专有发布列表。
在版本选择时,应注意以下要点:
- 操作系统版本兼容: Python 3.9 及以上版本不再支持 Windows 7。Windows 10 和 Windows 11 可以自由安装最新的稳定版本(如 Python 3.11 或 3.12)。
- 架构对应: 现代计算机绝大部分运行 64 位 Windows 系统。在安装包列表中应明确选择带有 Windows installer (64-bit) 标识的文件,而不是 32 位(x86)或嵌入式(embeddable)压缩包。
- 安装包类型: 选择扩展名为
.exe的可执行安装向导,它整合了完整运行时、标准库以及pip包管理工具。
二、运行安装向导与勾选 Add to PATH
下载完成后,双击运行扩展名为 .exe 的安装程序。安装向导的第一屏是决定后续使用体验最关键的一个界面。
1. 勾选 Add python.exe to PATH
在默认状态下,安装界面最下方的 Add python.exe to PATH(较早版本可能标为 Add Python 3.x to PATH)是没有被勾选的。请在点击任何安装按钮之前,第一件事就是勾选此项。
勾选该选项的根本目的,是授权安装程序在注册表的用户环境变量中,自动追加 Python 的安装路径和 Scripts 路径。只有完成了这一配置,后续在命令提示符(CMD)或 PowerShell 中直接输入 python 或 pip 时,操作系统才能准确命中并执行这两个程序。
2. 选择安装方式
- Install Now(立即安装): 推荐初学者使用。程序会安装到当前用户的
AppData局部目录下,同时默认安装标准库、IDLE 开发环境、文档以及 pip 工具。 - Customize installation(自定义安装): 适合需要统一管理软件路径的高级用户。点击进入后,可保留所有可选功能(Documentation、pip、tcl/tk、Python test suite、py launcher),在高级选项(Advanced Options)中勾选“Install for all users”,并将安装路径修改为更加简短规整的位置,例如
C:\Python312。
选定方式后点击安装,系统弹出用户账户控制(UAC)对话框时选择“是”,等待安装进度完成即可。安装结束后若提示“Disable path length limit”(解除路径长度限制),建议点击以允许 Python 脚本在深度嵌套路径下正常读写。
三、验证安装结果与基本命令测试
安装向导关闭后,必须通过命令行验证 Python 是否已经被系统正确识别并就绪。
1. 打开终端工具
按下键盘快捷键 Win + R,在打开的“运行”窗口中输入 cmd 并回车,启动命令提示符;或者在开始菜单图标上右键选择“终端”或“Windows PowerShell”。
注意: 如果在运行安装向导之前已经打开了命令提示符,请必须先将其关闭并重新打开。因为已经开启的终端窗口不会自动重新读取更新后的环境变量。
2. 执行版本检查命令
在终端中依次输入并执行以下两条命令:
python --version
示例输出:
Python 3.12.3
紧接着检查随 Python 一同安装的包管理工具 pip:
pip --version
示例输出:
pip 24.0 from C:\Users\Username\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)
若两条命令均能正常回显具体的版本号与路径,说明 Python 核心程序与包管理器的环境变量均已生效,安装大功告成。
四、遗漏勾选时的补救:手动配置环境变量
如果安装时忘记勾选 Add python.exe to PATH,无需卸载重装,可以直接通过 Windows 系统的“高级系统设置”手动配置环境变量。
1. 定位 Python 实际安装路径
在配置前,必须先确定 Python 具体安装到了哪个文件夹:
- 如果使用的是默认的 Install Now,路径通常位于当前用户的隐藏数据文件夹中:
C:\Users\<你的用户名>\AppData\Local\Programs\Python\Python312\
(AppData文件夹默认为隐藏状态,可在文件资源管理器顶部点击“查看”并勾选“隐藏的项目”以显现)。 - 如果使用的是 Customize installation,路径则是你当时自定义选择的位置,如
C:\Python312\。
找到该目录后,进入该文件夹,再找到其中的 Scripts 子文件夹。记下这两个路径。
2. 进入环境变量编辑界面
- 按下快捷键
Win + S打开系统搜索,输入“环境变量”,点击匹配出的“编辑系统环境变量”或“编辑账户的环境变量”;或者在桌面上右键“此电脑”选择“属性”,在右侧相关链接中点击“高级系统设置”,随后点击下方的“环境变量”按钮。 - 在弹出的对话框中,分为上方的“用户变量”和下方的“系统变量”。如果只想对当前用户生效,选择用户变量即可;若希望整台电脑所有用户都能调用,选择系统变量。
- 在变量列表中找到名为
Path(或PATH)的一项,选中后点击“编辑”按钮。
3. 新增路径条目
在“编辑环境变量”窗口中,点击右侧的“新建”按钮,依次添加以下两条完整路径:
C:\Users\Username\AppData\Local\Programs\Python\Python312\
C:\Users\Username\AppData\Local\Programs\Python\Python312\Scripts\
(注意将上述路径中的 Username 与 Python312 替换为您电脑中的实际用户名与版本目录名)。
添加完成后,连续点击三次“确定”按钮关闭所有设置窗口,确保配置已正式保存入系统注册表。
五、常见问题与排错方法
在配置和运行过程中,如果遇到终端未按预期响应的情况,可以参考以下具体表现进行定位和解决。
1. 输入 python 却弹出微软应用商店
这是 Windows 10 和 Windows 11 用户经常遇到的现象。Windows 系统内置了一个名为“应用执行别名”的机制,默认将 python.exe 指向应用商店的下载引导。当你的环境变量中没有 Python 路径,或者 WindowsApps 别名排在你的 Python 路径之前时,系统就会直接打开商店。
解决方法:
- 按下
Win + I打开 Windows 设置。 - 依次进入“应用” → “高级应用设置” → “应用执行别名”。
- 在列表中向下滚动,找到“应用安装程序 (python.exe)”和“应用安装程序 (python3.exe)”,将其右侧的开关全部切换为“关”。
- 重新打开终端输入
python --version即可恢复正常。
2. 提示“不是内部或外部命令”
如果终端提示 'python' 不是内部或外部命令,也不是可运行的程序或批处理文件,通常由以下三个原因造成:
- 未重新打开终端: 修改环境变量后,已开启的终端不会动态刷新,必须将其彻底关闭再重新打开。
- 路径遗漏反斜杠或拼写错误: 检查在环境变量中填写的路径是否包含多余的双引号、空格或错别字,确保该文件夹下确实存在
python.exe。 - 未配置 Scripts 导致 pip 报错: 如果
python可以运行但pip报错,说明只添加了主目录而漏掉了Scripts目录。补充添加后即可解决。
3. 使用 Python Launcher (py 启动器)
Windows 安装包默认还会安装一个名为 py.exe 的专用启动器(通常安装在 C:\Windows\ 目录下,默认天然包含在全局系统路径中)。即使没有配置 Python 环境变量,直接在终端中运行以下命令也能正常拉起 Python:
py --version
py -3.12 main.py
对于在同一台电脑上安装了多个 Python 版本的开发者,使用 py 启动器搭配版本参数也是管理和切换多环境的高效方式。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













