Windows手动配置Python 3.9环境变量的详细教程

顾星河
顾星河
发布时间:2026-11-22 | 18人浏览过
原创

详细讲解在Windows系统中手动配置Python 3.9环境变量的完整流程,涵盖安装路径确认、Path变量新增规则、终端命令验证与常见报错排查。

在 Windows 安装 Python 3.9 时,如果未勾选“Add Python 3.9 to PATH”,系统终端便无法直接识别 python 和 pip 指令。配置环境变量的核心目的,是把 Python 可执行程序及其工具脚本所在的目录添加到操作系统的搜索路径表中。本文按标准操作顺序,介绍 Windows 命令检索机制、安装路径确认、Path 变量设置、终端验证与常见冲突排查。

一、Windows 环境中 Path 变量的作用与检索机制

当在命令提示符(CMD)或 PowerShell 中输入一个命令(如 python)并按下回车时,Windows 并不是去全盘扫描文件,而是按照一套固定的顺序寻找同名可执行文件。首先查找当前命令行所在的目录;如果在当前目录没有找到,就会读取系统环境变量中的 Path 列表,从前往后逐个目录比对。

如果在所有已登记的路径中都没有找到 python.exe,终端便会输出经典提示:“'python' 不是内部或外部命令,也不是可运行的程序或批处理文件”。手动配置环境变量,就是把 Python 3.9 的主程序目录与工具脚本目录写入该列表。

Windows手动配置Python 3.9环境变量的详细教程
图 1:Windows 命令提示符查找并调用 python 可执行文件的基本逻辑流程

二、定位 Python 3.9 的关键安装路径

配置环境变量前,必须准确取得两个真实存在的绝对路径。许多初学者常犯的错误是只添加主程序目录,导致后续运行 pip install 安装第三方包时提示找不到命令。Python 3.9 的正常运行依赖以下两个路径:

  1. 主程序目录:包含 python.exe,负责执行 Python 脚本与启动交互式控制台。
  2. Scripts 脚本目录:位于主程序目录下的 Scripts 文件夹,包含 pip.exe、wheel.exe 等包管理工具。

常见默认安装位置查找

根据安装 Python 3.9 时所选模式不同,目录通常位于以下两个位置之一(请将下方的 <用户名> 替换为实际的 Windows 登录用户名):

  • 仅为当前用户安装(默认推荐安装):
    C:\Users\<用户名>\AppData\Local\Programs\Python\Python39\
    C:\Users\<用户名>\AppData\Local\Programs\Python\Python39\Scripts\
    注:AppData 文件夹在 Windows 中默认处于隐藏状态,在文件资源管理器中需点击“查看”并勾选“隐藏的项目”。
  • 为所有用户安装(自定义勾选 Install for all users):
    C:\Program Files\Python39\
    C:\Program Files\Python39\Scripts\
Windows手动配置Python 3.9环境变量的详细教程
图 2:Python 3.9 主程序与 Scripts 目录在环境变量中的双轨配置要求

三、手动配置环境变量的详细操作步骤

确认好上述两个文件夹的具体路径后,即可通过系统属性界面完成配置。以下是完整的操作步骤:

第 1 步:快速打开环境变量设置界面

按下键盘快捷键 Win + R 呼出“运行”对话框,输入 sysdm.cpl 并按下回车,即可直接打开“系统属性”窗口。切换到顶部的“高级”选项卡,点击右下角的“环境变量”按钮。

第 2 步:选择“用户变量”或“系统变量”

在打开的“环境变量”界面中,分为上下两个区域:

  • 用户变量(上方):仅对当前登录的 Windows 用户账号生效。如果电脑仅供个人使用,修改此处最为稳妥且无需管理员权限。
  • 系统变量(下方):对使用这台电脑的所有系统用户均生效。如果需要在系统服务或多账号环境下共享 Python 环境,建议在此处配置。

第 3 步:编辑 Path 变量并添加条目

  1. 在对应区域的变量列表中找到名为 Path 的项,选中后点击“编辑”。
  2. 在弹出的编辑窗口右侧点击“新建”按钮,粘贴准备好的 Python 3.9 根目录路径(例如:C:\Program Files\Python39)。
  3. 再次点击“新建”,粘贴 Scripts 目录路径(例如:C:\Program Files\Python39\Scripts)。
  4. 点击“上移”按钮,将这两条路径移动到相对靠前的位置,确保它们优先被系统检索。

第 4 步:逐层保存确认

配置完成后,必须依次点击各个窗口的“确定”按钮保存(包括“编辑环境变量”、“环境变量”及“系统属性”窗口),切勿直接点击右上角叉号关闭,否则刚才的编辑不会被保存到注册表中。

Windows手动配置Python 3.9环境变量的详细教程
图 3:手动配置 Path 环境变量的标准化步骤流程图

四、验证配置结果

注意:已经打开的 CMD 或 PowerShell 窗口不会自动更新环境变量缓存。完成上述保存步骤后,必须重新打开一个新的命令行窗口进行测试。

在全新的命令提示符中,依次输入以下命令核对执行结果:

1. 验证 Python 解释器

python --version

示例输出:

Python 3.9.13

如果输出显示具体的 Python 3.9.x 版本号,说明解释器路径已正确命中。

2. 验证包管理器 pip

pip --version

示例输出:

pip 20.2.3 from C:\Program Files\Python39\lib\site-packages\pip (python 3.9)

输出信息中应包含 python 3.9 及其安装路径,说明 Scripts 目录配置成功。

3. 查看实际命中的可执行文件位置

where python

示例输出:

C:\Program Files\Python39\python.exe
C:\Users\username\AppData\Local\Microsoft\WindowsApps\python.exe

where 命令会按检索顺序列出所有同名程序。排在第一行的一定要是你刚刚配置的 Python 3.9 路径。

五、常见问题与排查方法

异常现象 根本原因 针对性解决措施
输入 python 弹出微软应用商店(Microsoft Store) Windows 自带的零字节执行别名占用了 python 命名,优先级高于刚配置的路径。 打开“Windows 设置”→“应用”→“高级应用设置”→“应用执行别名”,将与 Python 相关的开关全部关闭。
输入命令依然提示“不是内部或外部命令” 未重启终端,或环境变量编辑时有多余中文字符/拼写错误。 彻底关闭并重开终端;检查 Path 中的斜杠是否为英文反斜杠 \,目录末尾不要有多余中文标点。
显示了其他版本的 Python(如 Python 3.8 或 3.10) 系统中安装了多个 Python 版本,且其他版本的路径在 Path 列表中排在 3.9 之前。 在 Path 列表中选中 Python 3.9 及其 Scripts 路径,点击“上移”将其移动到旧版本路径上方。
Windows手动配置Python 3.9环境变量的详细教程
图 4:配置完成后的验证步骤与三类典型分支处理总结
相关专题:

本站声明

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

Python 相关产品和应用

全部下载

专题列表