Python官网下载与Windows安装图文教程(含环境变量配置)
本教程详细介绍在Windows系统下从Python官网下载稳定安装包、执行图形化安装、配置PATH环境变量的完整步骤,并提供手动添加环境变量与终端验证排错指南。
在 Windows 系统中搭建 Python 开发环境,核心分为三个关键阶段:从官方网站获取与操作系统位数匹配的独立安装程序、在图形化向导中正确配置系统路径与安装选项,以及在命令行中检验 Python 解释器与 pip 工具链是否能够正常调用。本文将按实际操作路径逐项分解整个过程,并针对初学者容易遗漏的环境变量配置提供详细的手动设置方法与排查方案。
一、从 Python 官方网站获取安装包
获取 Python 安装包必须通过官方渠道,避免通过非官方下载站或第三方打包工具获取,以防捆绑插件或组件缺失。Python 官方网站地址为 python.org。
在浏览器中打开官网主页后,将鼠标悬停在顶部导航栏的 Downloads 菜单上。网站通常会自动识别访问者的操作系统,并在下拉浮层中显示类似“Download for Windows”的黄色快捷下载按钮。但在实际操作中,建议读者点击 Windows 子菜单进入完整的 Windows 版本发布列表页面,以便更精准地挑选符合需求的安装包类型。
安装包格式选型对照
| 文件格式标识 | 面向场景 | 初学者推荐度 | 核心特征 |
|---|---|---|---|
| Windows installer (64-bit) | 日常开发、常规学习与生产运行 | 强烈推荐 | 标准 .exe 图形向导,包含解释器、标准库、pip、IDLE及PATH写入功能 |
| Windows installer (32-bit) | 老旧32位专用操作系统或特定依赖 | 不推荐 | 单进程寻址受限于4GB内存,现代PC基本已全量使用64位 |
| Windows embeddable package | 软件项目打包、精简嵌入式运行 | 不推荐 | 免安装压缩包,默认不包含 pip 且无环境关联,需额外配置 |
二、运行安装程序与关键选项配置
下载完成后,双击运行扩展名为 .exe 的安装程序。Windows 系统可能会弹出用户账户控制(UAC)提示框,点击“是”继续。随后会进入 Python 安装向导的主界面。
安装向导第一页底部的选项直接决定了后续能否在终端里直接调用 Python 命令,也是初学者遇到“无法运行 python”最频繁的根源。请在这一步保持耐心并逐项确认。
详细安装步骤执行
- 勾选环境注入开关:在主界面底部,先勾选
Add python.exe to PATH,随后勾选Use admin privileges when installing py.exe。 - 选择自定义模式:点击 Customize installation 进入可选特性(Optional Features)页面。
- 保留核心特性:确认
Documentation、pip、tcl/tk and IDLE、Python test suite以及py launcher均保持勾选状态,点击 Next。其中pip必须选中,它是后续安装各类第三方扩展包的必要基础。 - 高级选项设置(Advanced Options):
- 勾选
Install Python for all users(为所有用户安装)。勾选后系统会将安装目录重定向至根目录级别,例如C:\Program Files\Python312或允许自由指定为C:\Python312。 - 勾选
Precompile standard library(预编译标准库),提升首次调用模块时的加载响应。 - 在 Customize install location 输入框中,建议将路径修改为一个简短且无空格、无中文字符的路径,例如
C:\Python312。避免将 Python 放置在包含空格或中文的个人用户文件夹下,防止某些第三方 C 扩展库编译时由于路径解析异常导致安装中断。
- 勾选
- 开始写入并完成:点击 Install 开始安装。安装完成后界面会显示“Setup was successful”。此时若出现
Disable path length limit(禁用 MAX_PATH 路径长度限制)的提示按钮,建议点击该按钮,解除 Windows 系统 260 字符的文件路径限制,最后点击 Close 退出向导。
三、Windows 环境变量手动配置详解
如果在第一步安装时未勾选 Add python.exe to PATH,或者需要接管多版本 Python 的共存管理,则需要手动将 Python 主程序目录与 Scripts 目录添加到 Windows 系统的 Path 环境变量中。
环境变量 Path 相当于操作系统的“快速寻址黄页”。当在命令行输入 python 或 pip 时,Windows 会优先在当前目录下寻找对应可执行文件;如果找不到,便会依次遍历 Path 中记录的每一个文件夹路径。只要对应程序的所在文件夹登记在 Path 中,命令就能在任何位置被识别。
手动配置的具体操作顺序
- 调出系统属性面板:按键盘组合键
Win + R打开“运行”对话框,输入sysdm.cpl并按回车;或者在任务栏搜索框中搜索“环境变量”,选择“编辑系统环境变量”。 - 进入环境变量窗口:在弹出的“系统属性”窗口中,切换到“高级”选项卡,点击右下角的 环境变量(N)... 按钮。
- 选择变量级别:在打开的面板中,上方是“当前用户的用户变量”,下方是“系统变量”。如果当前计算机仅有单人使用,建议在下方的“系统变量”列表中找到名为
Path的项;如果是共享工作站且没有管理员权限,则修改上方的用户变量Path。 - 新增路径条目:双击
Path或选中后点击 编辑。在弹出的列表右侧点击 新建:- 第一条输入 Python 的主安装目录,例如:
C:\Python312\(如果是默认安装,形如C:\Users\<用户名>\AppData\Local\Programs\Python\Python312\)。 - 再次点击 新建,输入 Scripts 目录,例如:
C:\Python312\Scripts\。
- 第一条输入 Python 的主安装目录,例如:
- 完成层级确认:添加完成后,连续点击三个对话框的 确定 按钮。切记不要直接点击“取消”或按 ESC 关闭窗口,否则修改不会存入注册表。
Path 才会加载生效。
四、安装结果验证与包管理器测试
完成安装与环境变量配置后,需要通过实际命令对环境进行可用性验证,确保主执行程序与配套的包管理工具均可正常调用。
1. 启动命令行终端
按 Win + R 键,输入 cmd 并回车打开命令提示符;或在开始菜单图标上右键,选择 Windows 终端 或 Windows PowerShell。
2. 检验 Python 版本
在终端窗口内输入以下命令并按回车:
python --version
若终端正确输出了安装的版本号,例如:
Python 3.12.3
说明系统已成功定位并启动了 Python 解释器。
3. 检验包管理工具 pip
继续在终端中输入 pip 版本查询指令:
pip --version
示例输出:
pip 24.0 from C:\Python312\Lib\site-packages\pip (python 3.12)
输出信息中包含 pip 的当前版本及其所在 Python 目录位置,表明 Scripts 目录的寻址同样准确无误。
4. 执行单行代码测试
使用 -c 参数直接在终端运行一段简单的代码片段:
python -c "print('Python 环境配置成功')"
若能在下一行清晰输出 Python 环境配置成功,即说明核心引擎运行正常。读者也可以直接输入 python 回车进入交互式 REPL 命令行(看到 >>> 提示符),输入 exit() 或按 Ctrl + Z 后回车即可退出交互模式。
五、常见问题排查与解决方法
1. 输入 python 后自动弹出 Windows 应用商店(Microsoft Store)
这是 Windows 10 与 Windows 11 中常见的系统“应用执行别名”机制导致的现象。当系统未能在有效路径找到真正的 python.exe,或者应用商店占位别名优先级更高时,就会自动触发商店跳转。
解决方法:
- 按
Win + I打开 Windows 设置。 - 依次进入 应用 > 高级应用设置 > 应用执行别名(Windows 10 位于“应用和功能”右侧)。
- 在列表中找到名为
应用安装程序 (python.exe)和应用安装程序 (python3.exe)的两个开关,将它们全部设置为 关闭。 - 关闭后重新打开终端,输入
python --version即可正常调用已安装的官方解释器。
2. 提示“'python' 不是内部或外部命令,也不是可运行的程序”
该提示表明命令解释器未能在系统检索路径中匹配到目标程序:
- 原因一:刚刚完成环境变量修改,但未重新开启 cmd / PowerShell 终端。请关闭所有终端窗口并重新打开。
- 原因二:在“环境变量”面板中添加的路径存在手写错别字(如将
Python312误拼成Python32),或者路径前后误加了英文双引号。建议直接在文件资源管理器中打开目标文件夹,复制地址栏真实路径贴入。 - 原因三:路径添加到了单用户的“用户变量”中,而当前是以另一个系统账户(或特定管理员身份)打开的终端窗口。建议将路径统一登记在下方的“系统变量”中的
Path。
3. 使用 pip 安装第三方包时提示 PermissionError 拒绝访问
当 Python 被安装在 C:\Program Files\Python312 等受 Windows UAC 保护的系统目录中时,普通终端权限可能无法直接向 site-packages 目录写入新文件。
解决方法:在开始菜单右键点击“终端”或“命令提示符”,选择 以管理员身份运行,然后再执行 pip install <包名>;或者在安装命令后追加 --user 参数(例如 pip install --user <包名>),将扩展模块安装至当前用户的个人主目录下。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









