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

Leo
Leo
发布时间:2026-11-02| 7人浏览过
原创

本教程详细介绍在Windows系统下安装Python 3.9的完整步骤,包括安装包选择、自定义路径设置、系统环境变量PATH的手动配置及终端验证排查方法。

在Windows系统上完成Python 3.9的部署与运行,核心任务由两个阶段组成:一是通过官方安装包将解释器本体和基础工具部署到磁盘中,二是将Python执行程序及脚本目录准确登记到系统的Path环境变量中。本文从下载选型、安装选项配置、环境变量手动设置到最终命令验证,提供完整且规范的操作说明。

一、准备工作与安装包获取

Python 3.9是很多数据科学、自动化脚本与机器学习项目广泛采用的长期稳定分支。在Windows环境下安装前,需要明确系统的运行要求与架构类型。

Windows 10及更新版本的系统原生支持Python 3.9。需要注意的是,从Python 3.9开始,官方正式放弃了对Windows 7及更早版本的原生支持(若必须在Windows 7上运行需安装专用系统补丁)。当前主流PC通常为64位操作系统,因此推荐下载64位安装包以获得更佳的内存支持与第三方库兼容性。

  • 安装包名称规范: 官方下载页面中对应的64位离线安装程序文件名为 python-3.9.x-amd64.exe(例如 python-3.9.13-amd64.exe)。
  • 下载来源核对: 建议直接访问Python官方网站的 Releases 列表,选择Python 3.9稳定版维护子版本中的 Windows installer (64-bit) 进行下载。
Windows系统安装Python 3.9及环境变量配置教程
图 1:Windows系统下Python 3.9安装与环境配置的标准流水线

二、安装向导详细配置与安装方式对比

双击下载的安装文件后,首先呈现的是安装引导主界面。在点击任何继续按钮前,必须先看清底部的两个关键复选框:

  • Install launcher for all users (recommended): 为系统所有用户安装启动器 py.exe,默认保持勾选。
  • Add Python 3.9 to PATH: 自动将Python加入当前用户的系统路径。务必手动勾选该选项。若安装时漏勾,后续则必须手动配置环境变量。

默认安装与自定义安装的关键差异

向导界面提供了“Install Now”和“Customize installation”两种入口。虽然“Install Now”操作简单,但在开发实践中,“Customize installation”(自定义安装)具有明显优势。下表对比了两者的差异:

对比维度 默认安装 (Install Now) 自定义安装 (Customize installation)
安装目标路径 C:\Users\<用户名>\AppData\Local\Programs\Python\Python39 自定义规范浅层目录,例如 C:\Python39 或 D:\Python39
路径字符风险 若Windows用户名包含中文或空格,极易导致pip构建wheel时报错 路径清晰纯英文无空格,彻底规避各类脚本解析异常
多用户支持 仅当前登录用户可用 可勾选“Install for all users”,全局账户均可调用
日常维护管理 路径深、隐藏于AppData,查找site-packages包较为繁琐 目录层级一目了然,管理模块、查看源码及配置虚拟环境便捷
Windows系统安装Python 3.9及环境变量配置教程
图 2:默认安装路径与自定义安装路径对比分析

推荐的自定义安装步骤

  1. 点击主界面上的 Customize installation。
  2. 在“Optional Features”(可选功能)界面,默认已全选(Documentation、pip、tcl/tk and IDLE、Python test suite、py launcher),保持全选并点击 Next。
  3. 在“Advanced Options”(高级选项)界面,执行以下设置:
    • 勾选 Install for all users(为所有用户安装)。
    • 勾选 Precompile standard library(预编译标准库,可提升首次载入速度)。
    • 将底部的 Customize install location 修改为结构清晰的路径,例如 C:\Python39。
  4. 点击 Install 开始复制文件并写入系统注册表。
  5. 安装完毕后,若提示“Disable path length limit”(禁用路径长度限制),建议点击该项,以解除Windows默认的260字符路径长度限制。

三、手动配置 Windows 环境变量 (PATH)

如果在安装时未勾选“Add Python 3.9 to PATH”,或者机器上存在多个Python环境需要调整优先级,必须通过Windows系统设置手动添加环境变量。

环境变量的作用原理

当我们在CMD或PowerShell中输入 python 或 pip 并回车时,Windows系统会按照Path变量中登记的目录列表,从上到下逐一查找是否存在同名的可执行文件。因此,完整的Python环境需要将两个目录加入Path:

  • 主程序目录: 例如 C:\Python39\,其中存放着 python.exe,负责响应解释器主程序调用。
  • 脚本与工具目录: 例如 C:\Python39\Scripts\,其中存放着 pip.exe 以及后续通过pip安装的各类工具(如 wheel、pytest、flake8 等)。若缺失此项,终端将无法直接识别 pip 命令。
Windows系统安装Python 3.9及环境变量配置教程
图 3:Windows Path 变量中主目录与 Scripts 目录的命中机制

手动配置环境变量的操作流程

  1. 调出系统属性窗口: 按下键盘组合键 Win + R 打开“运行”窗口,输入 sysdm.cpl 后按回车,可直接打开“系统属性”。
  2. 进入高级环境变量: 在“系统属性”窗口顶部切换至 高级 选项卡,点击右下角的 环境变量(N)... 按钮。
  3. 选择配置范围:
    • 用户变量: 仅对当前登录的Windows账户生效。
    • 系统变量(推荐): 对使用该计算机的所有用户生效。在“系统变量”列表中找到名为 Path 的变量,选中后点击 编辑(I)...。
  4. 添加Python相关路径: 在弹出的“编辑环境变量”窗口中,点击右侧的 新建(N) 按钮,依次输入:
    C:\Python39\
    C:\Python39\Scripts\
    (若实际安装在其他盘符或自定义目录,请替换为对应的绝对路径)
  5. 调整项位置顺序: 选中刚刚添加的条目,利用右侧的 上移(U) 按钮将其移动到较靠前的位置。这可以确保当系统中存在其他工具或旧版本时,优先执行Python 3.9。
  6. 逐层确定保存: 依次点击“编辑环境变量”、“环境变量”及“系统属性”窗口底部的 确定 按钮,确保更改被系统正式写入并持久化。

四、环境验证与常见问题排查

完成安装与环境变量设置后,需要对环境可用性进行严格验证。请注意:已经处于打开状态的CMD或PowerShell窗口不会自动读取最新的环境变量,必须关闭现有窗口并重新启动一个全新的终端。

1. 终端执行基础验证

按下 Win + R 输入 cmd 回车,分别执行以下命令:

C:\Users\Username> python --version
Python 3.9.13

C:\Users\Username> pip --version
pip 22.0.4 from C:\Python39\lib\site-packages\pip (python 3.9)

C:\Users\Username> where python
C:\Python39\python.exe
C:\Users\Username\AppData\Local\Microsoft\WindowsApps\python.exe

如果 python --version 与 pip --version 均能正常返回版本号,且 where python 优先展示你所配置的 C:\Python39\python.exe,则说明Python 3.9已完全配置就绪。

Windows系统安装Python 3.9及环境变量配置教程
图 4:Python命令响应判定分支与排查流程

2. 常见问题与针对性排查方案

问题一:执行 python 自动弹出微软应用商店 (Microsoft Store)

这是 Windows 10/11 的内置行为:系统默认在 %LOCALAPPDATA%\Microsoft\WindowsApps 中注册了空壳占位引导程序。如果该目录在Path中的顺序高于自定义Python目录,就会被抢先截获。
彻底解决方式: 打开 Windows“设置” → 进入“应用” → 点击“高级应用设置”或“应用和功能”中的 应用执行别名(App execution aliases),在列表中找到“应用安装程序 (python.exe)”与“应用安装程序 (python3.exe)”,将其右侧开关切换为 关。

问题二:提示“'python' 不是内部或外部命令,也不是可运行的程序”

这说明系统的Path变量中完全没有匹配到 python.exe。请按以下顺序检查:
1. 确认环境变量设置后,是否重新打开了CMD窗口。
2. 重新打开“环境变量”窗口,核对填入的路径字符串是否有多余的分号、空格或引号,例如 C:\Python39\ 是否存在物理文件 python.exe。
3. 检查当前账户权限是否受限,若是受限账户,可将路径配置在“当前用户的用户变量”下的Path中。

问题三:可以运行 python,但提示“'pip' 不是内部或外部命令”

这是因为只在Path中添加了主程序目录,遗漏了脚本目录。请将 C:\Python39\Scripts\ 加入到Path环境变量中。若临时需要调用pip,也可以使用解释器原生模块语法代替执行:python -m pip install <package_name>。

总结

Windows系统下Python 3.9的部署重点在于规范化:采用自定义安装将目录扁平化设置在纯英文字符路径(如 C:\Python39),避开用户文件夹中文编码隐患;同时将主程序路径与 Scripts 脚本路径登记至系统Path环境变量,并关闭WindowsApps别名干扰。按照此标准流程配置的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 算法库。