Windows系统手动配置Python环境变量的详细步骤

苏见山
苏见山
发布时间:2026-11-16| 3人浏览过
原创

详细介绍在Windows操作系统中手动配置Python环境变量的具体步骤,包括查找Python与Scripts真实安装路径、编辑系统Path变量、验证配置以及常见报错排查。

手动配置 Windows 下的 Python 环境变量,本质上是将 Python 主程序所在的安装目录以及存放第三方工具的 Scripts 目录,登记到操作系统的 Path 变量列表中。配置完成后,无论读者在系统的哪个文件夹下打开命令提示符,直接输入 python 或 pip 即可启动解释器或执行包管理命令,而无需每次都输入冗长繁琐的完整文件路径。

核心配置目标:本文将带读者获取两个关键路径(Python 安装根目录与 Scripts 目录),并通过 Windows 系统属性界面将它们规范添加到用户或系统的 Path 变量中,最后在命令行中完成正确性验证与常见冲突排查。

一、为什么需要手动配置 Path 环境变量

在 Windows 系统中,当用户在命令行终端(CMD 或 PowerShell)中输入一个命令(如 python)并按下回车时,操作系统并不会全盘扫描所有硬盘分区去寻找该程序,而是遵循固定的检索顺序:先在当前工作目录下查找对应文件,若未找到,便会遍历系统预先记录在 Path 环境变量中的所有目录。一旦在某个目录下找到了匹配的 python.exe,系统就立即将其加载并执行;如果遍历完所有 Path 路径仍未找到,就会弹出读者常见的报错信息:“'python' 不是内部或外部命令,也不是可运行的程序”。

Windows系统手动配置Python环境变量的详细步骤
图 1:Windows 操作系统检索并执行 Python 命令的底层逻辑

二、准备工作:获取两项核心安装路径

在进行系统配置之前,必须准确获取当前计算机上 Python 的真实物理安装路径。配置环境变量并不是输入一个泛指的名字,而是需要提供确切的文件绝对路径。通常必须准备以下两个路径:

  • Python 主程序目录:存放 python.exe 解释器本体、标准库文件及运行环境核心 DLL。
  • Scripts 脚本目录:位于主程序目录的下一级,专门存放 pip.exe 包管理工具以及日后通过 pip 安装的各类工具程序(如 wheel、pytest、flake8、uvicorn 等)。
Windows系统手动配置Python环境变量的详细步骤
图 2:Python 根目录与 Scripts 目录的结构及主要程序分工

如何找到这两个路径?

如果读者在安装 Python 时采用的是官方推荐安装包,且没有更改自定义路径,通常默认路径规则如下:

安装方式 Python 主安装路径 Scripts 脚本路径
仅为当前用户安装(默认) C:\Users\<用户名>\AppData\Local\Programs\Python\Python312\ C:\Users\<用户名>\AppData\Local\Programs\Python\Python312\Scripts\
为所有用户安装(勾选 All Users) C:\Program Files\Python312\ C:\Program Files\Python312\Scripts\

如果读者的计算机上已经可以通过开始菜单找到 Python IDLE,也可以直接打开 IDLE 并在交互窗口中输入以下两行代码获取准确路径:

import sys
print(sys.executable)

返回结果例如 C:\Users\Admin\AppData\Local\Programs\Python\Python312\python.exe,去掉末尾的文件名 python.exe 即为主目录;在该目录下进入 Scripts 文件夹即为第二条路径。

三、手动配置环境变量的具体操作步骤

获取两条准确路径后,即可通过 Windows 系统设置界面将其写入环境变量。以下是标准化操作步骤:

Windows系统手动配置Python环境变量的详细步骤
图 3:Windows 手动配置 Python 环境变量的四大核心步骤

步骤 1:打开“系统属性”高级面板

同时按下键盘上的快捷键 Win + R 唤出“运行”对话框,在输入框中输入:

sysdm.cpl

按下回车或点击“确定”,系统会直接弹出“系统属性”窗口。在该窗口顶部切换至“高级”选项卡,随后在窗口底部右侧点击“环境变量(N)...”按钮。

步骤 2:选择“用户变量”或“系统变量”中的 Path

在弹出的“环境变量”窗口中,上下分为两个区域:

  • 上半部分为“XXX 的用户变量”:仅对当前登录的 Windows 账户有效。如果当前使用的是公司电脑且没有管理员特权,或者只希望当前账户使用该 Python,请在上方区域找到并选中 Path。
  • 下半部分为“系统变量”:对使用这台电脑的所有用户账户全局生效。如果读者是电脑管理员且希望所有本地账户均可使用,请在下方系统变量区域找到并选中 Path。

选中 Path 一行后,点击下方的“编辑(E)...”按钮。

步骤 3:在 Path 列表中添加两条路径

进入“编辑环境变量”窗口后,右侧提供了一列操作按钮:

  1. 点击右侧第一行的“新建(N)”按钮,左侧列表最下方会出现一个光标输入框;
  2. 将准备好的 Python 主安装目录(如 C:\Users\Admin\AppData\Local\Programs\Python\Python312\)粘贴进去;
  3. 再次点击右侧的“新建(N)”按钮;
  4. 将 Scripts 目录(如 C:\Users\Admin\AppData\Local\Programs\Python\Python312\Scripts\)粘贴进去;
  5. 重要推荐:选中刚添加的两行,点击右侧的“上移(U)”按钮,将其移动到列表靠前的位置(建议排在 WindowsApps 别名路径之前,避免系统默认占位符干扰)。

步骤 4:层层点击“确定”保存设置

配置完成后,必须依次在“编辑环境变量”窗口点击“确定”,在“环境变量”窗口点击“确定”,最后在“系统属性”窗口点击“确定”。必须连点三次确定,配置才会被正式持久化保存到 Windows 注册表中。

四、验证配置结果

配置保存后,必须在新启动的终端进程中进行验证。由于已经打开的命令提示符只保留了启动那一刻的环境变量镜像,无法感知之后的修改,因此必须彻底关闭现有的命令行窗口并重新打开一个新的 CMD 或 PowerShell 窗口。

验证操作:按下 Win + R,输入 cmd 并回车,随后依次执行以下三条测试命令。

1. 验证 Python 解释器

python --version

正常输出示例:

Python 3.12.3

若能够正确打印出 Python 及对应的三位版本号,说明系统已成功定位到 python.exe。

2. 验证 pip 包管理器

pip --version

正常输出示例:

pip 24.0 from C:\Users\Admin\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)

若能输出 pip 版本号以及其所关联的 Python 路径,说明 Scripts 目录配置同样正确生效。

3. 检查系统定位的具体可执行文件路径

在 CMD 中运行 where 命令,可以清楚看到当前命令行实际调用的程序具体存放在哪个物理路径:

where python

正常输出示例:

C:\Users\Admin\AppData\Local\Programs\Python\Python312\python.exe

五、常见问题排查与注意事项

如果在验证过程中未得到预期结果,通常是由以下几种典型原因导致的,读者可按顺序排查修复:

Windows系统手动配置Python环境变量的详细步骤
图 4:配置验证过程中的排查逻辑与解决方法

1. 输入 python 后直接打开了微软应用商店 (Microsoft Store)

这是 Windows 10 与 Windows 11 中非常多初学者遇到但容易困惑的情况。原因在于 Windows 系统预装了名为“应用执行别名 (App Execution Aliases)”的占位程序,它在 Path 中的位置通常位于较上方。当系统检索不到用户配置的真实 Python 时,或者别名目录排在真实路径之前时,就会触发该占位符并引导用户去应用商店购买或下载。

解决方法:

  1. 打开 Windows“设置”(快捷键 Win + I);
  2. 在左侧进入“应用”,点击“高级应用设置”(部分系统版本为“应用和功能”);
  3. 找到并点击“应用执行别名”;
  4. 在列表中找到名为“应用安装程序 (python.exe)”和“应用安装程序 (python3.exe)”的两项开关,将它们全部切换为关闭状态;
  5. 回到“编辑环境变量”窗口,确保前面添加的真实 Python 路径使用“上移”按钮置顶。

2. 修改配置后命令仍然提示未找到

  • 旧终端缓存:必须完全关闭旧的 CMD 窗口。部分集成开发环境(如 VS Code)内嵌的终端也必须彻底关闭终端面板并重新开启,才能继承最新的环境变量。
  • 路径含有冗余字符:在编辑 Path 变量时,Windows 已经按条目自动分隔,每一条独立占用一行,因此条目内部不要手动添加分号 (;),也不要在开头或结尾添加双引号。
  • 漏加 Scripts 目录:如果 python 可以运行但 pip 无法识别,100% 是因为漏掉了以 \Scripts\ 结尾的第二条路径。

3. 多版本 Python 共存时的优先级

如果在电脑上同时安装了不同版本的 Python(例如 Python 3.10 与 Python 3.12),系统会严格按照“编辑环境变量”列表中自上而下的排列顺序进行查找。排在最上方的版本会被优先匹配并作为默认的 python 命令启动。若需要切换默认使用的版本,只需在 Path 编辑窗口中,选中对应版本的路径条目,点击“上移”使其位于其他版本之上即可。

六、总结

手动配置 Windows 环境变量虽然看起来步骤繁多,但本质逻辑极其清晰:找到路径 -> 登记到 Path -> 新开终端验证。只要读者准确获取了主程序与 Scripts 目录、在系统属性中完整保存,并避开 Windows 应用商店别名的干扰,就能稳定建立起整洁可靠的 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 算法库。