Windows安装Python详细教程:下载、勾选Add to PATH及环境变量配置

巷口听风
巷口听风
发布时间:2026-11-21 | 4人浏览过
原创

Windows操作系统下安装Python的完整图文教程,详解从官网下载稳定版本、安装向导中勾选Add to PATH的核心意义、命令行验证步骤,以及遗漏勾选时的系统环境变量手动配置方法与常见报错排查。

在Windows系统上安装Python并不复杂,但其中最关键的一步是让系统能够识别并定位Python的执行程序。完整的安装过程分为三个阶段:从官方网站获取对应位数的安装程序、在安装向导中勾选“Add python.exe to PATH”、以及在终端中进行验证。如果在安装时漏掉了该选项,也可以通过手动配置系统环境变量来完成补救。本文将按实际操作路径逐项讲解。

Windows安装Python详细教程:下载、勾选Add to PATH及环境变量配置
图 1:Windows 安装与验证整体逻辑流

一、下载 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 的安装程序。安装向导的第一屏是决定后续使用体验最关键的一个界面。

Windows安装Python详细教程:下载、勾选Add to PATH及环境变量配置
图 2:向导界面核心复选框及作用原理解析

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 系统的“高级系统设置”手动配置环境变量。

Windows安装Python详细教程:下载、勾选Add to PATH及环境变量配置
图 3:Windows 环境变量配置与 Python 目录对应关系

1. 定位 Python 实际安装路径

在配置前,必须先确定 Python 具体安装到了哪个文件夹:

  • 如果使用的是默认的 Install Now,路径通常位于当前用户的隐藏数据文件夹中:
    C:\Users\<你的用户名>\AppData\Local\Programs\Python\Python312\
    (AppData 文件夹默认为隐藏状态,可在文件资源管理器顶部点击“查看”并勾选“隐藏的项目”以显现)。
  • 如果使用的是 Customize installation,路径则是你当时自定义选择的位置,如 C:\Python312\。

找到该目录后,进入该文件夹,再找到其中的 Scripts 子文件夹。记下这两个路径。

2. 进入环境变量编辑界面

  1. 按下快捷键 Win + S 打开系统搜索,输入“环境变量”,点击匹配出的“编辑系统环境变量”或“编辑账户的环境变量”;或者在桌面上右键“此电脑”选择“属性”,在右侧相关链接中点击“高级系统设置”,随后点击下方的“环境变量”按钮。
  2. 在弹出的对话框中,分为上方的“用户变量”和下方的“系统变量”。如果只想对当前用户生效,选择用户变量即可;若希望整台电脑所有用户都能调用,选择系统变量。
  3. 在变量列表中找到名为 Path(或 PATH)的一项,选中后点击“编辑”按钮。

3. 新增路径条目

在“编辑环境变量”窗口中,点击右侧的“新建”按钮,依次添加以下两条完整路径:

C:\Users\Username\AppData\Local\Programs\Python\Python312\
C:\Users\Username\AppData\Local\Programs\Python\Python312\Scripts\

(注意将上述路径中的 Username 与 Python312 替换为您电脑中的实际用户名与版本目录名)。

添加完成后,连续点击三次“确定”按钮关闭所有设置窗口,确保配置已正式保存入系统注册表。

五、常见问题与排错方法

在配置和运行过程中,如果遇到终端未按预期响应的情况,可以参考以下具体表现进行定位和解决。

Windows安装Python详细教程:下载、勾选Add to PATH及环境变量配置
图 4:验证阶段常见问题排查与修复流程

1. 输入 python 却弹出微软应用商店

这是 Windows 10 和 Windows 11 用户经常遇到的现象。Windows 系统内置了一个名为“应用执行别名”的机制,默认将 python.exe 指向应用商店的下载引导。当你的环境变量中没有 Python 路径,或者 WindowsApps 别名排在你的 Python 路径之前时,系统就会直接打开商店。

解决方法:

  1. 按下 Win + I 打开 Windows 设置。
  2. 依次进入“应用” → “高级应用设置” → “应用执行别名”。
  3. 在列表中向下滚动,找到“应用安装程序 (python.exe)”和“应用安装程序 (python3.exe)”,将其右侧的开关全部切换为“关”。
  4. 重新打开终端输入 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 启动器搭配版本参数也是管理和切换多环境的高效方式。

相关专题:

本站声明

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

Python 相关产品和应用

全部下载

专题列表